当前位置:网站首页 > 更多 > 玩电脑 > 正文

[玩转系统] 如何使用 Add-ADGroupMember 在 PowerShell 中将用户添加到组

作者:精品下载站 日期:2024-12-14 03:42:49 浏览:16 分类:玩电脑

如何使用 Add-ADGroupMember 在 PowerShell 中将用户添加到组


当您需要将多个用户添加到 Active Directory 组时,使用 PowerShell 确实是您的最佳选择。您可以使用 PowerShell 快速将用户添加到组中,而无需手动查找所有用户。

在 AD 组中添加或删除用户是系统管理员的日常任务之一。当只有单个用户时,您可以完美地使用 Active Directory 管理控制台。但是,当您需要批量更新用户时,PowerShell 就是最佳选择。

在本文中,我将解释如何使用 PowerShell 将单个或多个用户添加到组中。此外,我们还将了解如何使用 CSV 文件将用户添加到组中。最后,您将找到两个 PowerShell 脚本,可让您轻松导入 CSV 文件。

PowerShell - 使用 Add-ADGroupMember 将用户添加到组

要将用户添加到 PowerShell 中的组,我们将使用 Add-ADGroupMember cmdlet。在开始之前,请确保您已安装 PowerShell Active Directory 模块。

Add-ADGroupMember cmdlet 可用于将用户、服务帐户、计算机甚至其他组添加到 AD 组。该 cmdlet 仅需要您要添加成员的组的标识以及要添加的成员列表。

要指定组和成员,我们可以使用以下值:

  • 专有名称
  • 对象 GUID (GUID)
  • objectSid(安全标识符)
  • SAMAccountName(安全帐户管理员帐户名)

因此,要将单个用户添加到组“SG_PowerBi”,我们可以使用组名称,即该组的 SAMAccountName。对于用户,我们将使用 SAMAccountName:

# Adding user Alan Rhodes to the group SG_PowerBi
Add-ADGroupMember -Identity "SG_PowerBi" -Members arhodes

该命令不会给出任何输出,但我们可以使用 Get-ADGroupMember cmdlet 通过 PowerShell 验证成员:

 Get-ADGroupMember -Identity "SG_PowerBi" | ft

[玩转系统] 如何使用 Add-ADGroupMember 在 PowerShell 中将用户添加到组

将多个用户添加到组中

也可以使用 Active Directory 用户和计算机控制台将单个用户添加到组中。但是,当您需要将多个用户添加到组中时,使用 PowerShell 会快得多。

有多种方法可以使用 PowerShell 将多个用户添加到组中。最常见的选项是简单地指定用户:

# Adding the users Alan Rhodes, Flenn Parker and Mike Reyes to the group SG_PowerBi
Add-ADGroupMember -Identity "SG_PowerBi" -Members arhodes, fparker, mreyes

但这需要您知道每个用户的 SAMAccountName。另一种选择是首先根据过滤器(例如职位)获取用户,然后将其添加到组中。为了获取用户,我们将使用 Get-ADUser cmdlet。

我们首先要获取所有职位为“客户经理”的用户,然后将每个用户添加到组 SG_PowerBi 中:

# Get all users with the job title "Account Manager" and add them to the group SG_PowerBi
Get-ADUser -Filter "title -eq 'account manager'" | ForEach-Object { Add-ADGroupMember -Identity "SG_PowerBi" -Members $_ }

使用 PowerShell 将组成员复制到另一个组

还可以使用 PowerShell 将组成员复制到另一个组。但请记住,您还可以将一个组添加到 Active Directory 中的另一个组。

要复制组成员,我们首先要获取现有组的所有成员并将它们复制到新组。为此,我们将使用 Get-ADGroupMember cmdlet。

# Get all the users from the group Sales Management and add them to the group SG_PowerBi
Get-ADGroupMember -Identity "Sales Management" | ForEach-Object { Add-ADGroupMember -Identity "SG_PowerBi" -Members $_ }

作为替代方案,您也可以将“销售管理”组添加到“SG_PowerBi”组:

Add-ADGroupMember -Identity "SG_PowerBi" -Members "Sales Management"

使用 PowerShell 从 CSV 将用户添加到组

当您需要将大量用户添加到组中时,有时使用 CSV 文件更容易。在 CSV 文件中,我们可以轻松添加所有用户。使用 PowerShell,我们可以读出 CSV 文件并将所有用户添加到正确的组中。

我创建了一个小型 PowerShell 脚本,它将导入 CSV 文件并将 CSV 文件中的所有用户添加到所选组。我已使脚本尽可能灵活,因此对于用户,您可以使用他们的显示名称、电子邮件或 UserPrincipalName。

这些脚本需要组名称和 CSV 文件的路径。默认情况下,它将使用逗号作为 CSV 文件的分隔符,并根据显示名称搜索用户。

对于 CSV 文件,您可以创建一个包含用户的简单列表,无需在 CSV 文件内添加标题:

Bob Davis,
Erik Parker,
Jean Miles,
Kelly Rices,
Margie Baker,
Mathew Scott,
Owen Hopkins,

您可以从下面复制脚本或从我的 Github 页面下载它。

[CmdletBinding()]
param (
    [Parameter(
      Mandatory = $true,
      HelpMessage = "Group name"
    )]
    [string] $groupName = "",

    [Parameter(
      Mandatory = $true,
      HelpMessage = "Path to CSV file"
    )]
    [string] $path = "",

    [Parameter(
      Mandatory = $false,
      HelpMessage = "CSV file delimiter"
    )]
    [string] $delimiter = ",",

    [Parameter(
      Mandatory = $false,
      HelpMessage = "Find users on DisplayName, Email or UserPrincipalName"
    )]
    [ValidateSet("DisplayName", "Email", "UserPrincipalName")]
    [string] $filter = "DisplayName"
)

Function Add-UsersToGroup {
    <#
    .SYNOPSIS
      Get users from the requested DN
    #>
    process{
        # Import the CSV File
        $users = (Import-Csv -Path $path -Delimiter $delimiter -header "name").name

        # Find the users in the Active Directory
        $users | ForEach {
            $user =  Get-ADUser -filter "$filter -eq '$_'" | Select ObjectGUID 

            if ($user) {
                Add-ADGroupMember -Identity $groupName -Members $user
                Write-Host "$_ added to the group"
            }else {
                Write-Warning "$_ not found in the Active Directory"
            }
        }
    }
}

# Load the Active Directory Module
Import-Module -Name ActiveDirectory

# Add user from CSV to given Group
Add-UsersToGroup

要根据用户的显示名称将用户从 CSV 文件添加到“SG_PowerBi”组,您可以运行以下命令:

.\Add-UsersToGroup.ps1 -GroupName "SG_PowerBi" -Path c:\temp\users.csv

如果您想使用UserPrincipalName,您将需要设置过滤器参数:

.\Add-UsersToGroup.ps1 -GroupName "SG_PowerBi" -Path c:\temp\users.csv -Filter "UserPrincipalName"

如果脚本无法在 Active Directory 中找到用户,则会显示警告。它将列出已添加到该组的所有用户。

[玩转系统] 如何使用 Add-ADGroupMember 在 PowerShell 中将用户添加到组

该脚本不会检查用户是否已经是组的成员,Add-ADGroupMember cmdlet 已在内部执行此操作。您可以将参数 -DisablePermissiveModify 添加到 Windows Server 2019 上的 cmdlet,以便在用户已存在时引发错误。

从 CSV 添加用户到不同的组

我还创建了该脚本的一个变体,允许您将用户批量添加到不同的组。通过这种方式,您可以创建一个 CSV 文件,其中一列包含用户以及您想要将其添加到的另一组。

此 CSV 文件需要列名称,因此第一列必须标记为用户,第二列必须标记为

User,Group
Bob Davis,SG_PowerBi
Erik Parker,SG_Visio
Jean Miles,SG_Visio
Kelly Rices,SG_PowerBi
Margie Baker,SG_PowerBi
Mathew Scott,SG_Visio
Owen Hopkins,SG_PowerBi

这次我们不需要指定组,只需指定 CSV 文件的路径,以及可选的分隔符和过滤器。

.\Add-UsersToDiffGroup.ps1 -path c:\temp\users.csv -filter "DisplayName"

[玩转系统] 如何使用 Add-ADGroupMember 在 PowerShell 中将用户添加到组

您可以复制下面的完整脚本或从我的 Github 页面下载。

[CmdletBinding()]
param (
    [Parameter(
      Mandatory = $true,
      HelpMessage = "Path to CSV file"
    )]
    [string] $Path = "",

    [Parameter(
      Mandatory = $false,
      HelpMessage = "CSV file delimiter"
    )]
    [string] $Delimiter = ",",

    [Parameter(
      Mandatory = $false,
      HelpMessage = "Find users on DisplayName, Email or UserPrincipalName"
    )]
    [ValidateSet("DisplayName", "Email", "UserPrincipalName")]
    [string] $Filter = "DisplayName"
)

Function Add-UserToGroup {
    <#
    .SYNOPSIS
      Get users from the requested DN
    #>
    process{
      # Import the CSV File
      $users = Import-Csv -Path $path -Delimiter $delimiter

      # Find the users in the Active Directory
      $users | ForEach {
          $user = Get-ADUser -filter "$filter -eq '$($_.user)'" | Select ObjectGUID 

          if ($user) {
              Add-ADGroupMember -Identity $_.Group -Members $user
              Write-Host "$($_.user) added to $($_.Group)"
          }else {
              Write-Warning "$($_.user) not found in the Active Directory"
          }
      }
  }
}

# Load the Active Directory Module
Import-Module -Name ActiveDirectory

# Add user from CSV to given Group
Add-UserToGroup

总结

使用PowerShell我们可以快速将用户添加到组中。如果您不知道用户的 SAMAccountName,则可以随时使用 Get-AdUser cmdlet 进行查找。如果您不熟悉使用 PowerShell 脚本,请务必阅读本文。

我希望这篇文章对您有用,如果您有任何疑问,请在下面发表评论。

您需要 登录账户 后才能发表评论

取消回复欢迎 发表评论:

关灯