如何使用 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

将多个用户添加到组中

也可以使用 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 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"

您可以复制下面的完整脚本或从我的 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 脚本，请务必阅读本文。

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