如何将成员添加到 Microsoft 365 组

Microsoft 365 组允许一组人员发送电子邮件并共享文件、日历和其他资源。有时您必须更新 Microsoft 365 组成员。在本文中，你将了解如何在 Microsoft Entra 管理中心和 PowerShell 中向 Microsoft 365 组添加成员。

Microsoft 365 组

每个组织最多可以在 Microsoft 365 中创建 500,000 个组。

Microsoft 365 Group	Maximum value
Number of owners per group	100
Number of members per group	More than 1,000*
Single user can create groups	250
Admin can create groups	500,000 (default tenant limit)
Number of groups a user can be a member of	1,000
File storage	1 TB 10 GB per subscribed user Additional storage purchased (unlimited)
Mailbox size	50 GB

*只有1,000人可以一起访问群组对话。

注意：用户在 Outlook 中访问非常大的组中的日历和对话时可能会注意到延迟。

如果没有 Microsoft 365 组，请了解如何在 Microsoft Entra 管理中心和使用 Microsoft Graph PowerShell 创建 Microsoft 365 组。

将成员添加到 Microsoft Entra ID 中的 Microsoft 365 组

要将成员添加到 Microsoft Entra 管理中心的 Microsoft 365 组，请按照以下步骤操作：

登录 Microsoft Entra 管理中心
展开身份 > 组 > 所有组
单击列表中的 Microsoft 365 组

点击成员

点击添加成员

选择用户
点击选择

您已成功将组成员添加到 Microsoft 365 组。

注意：在 Microsoft Entra 管理中心中，您最多可以选择 100 个用户并将他们添加为成员。因此，如果您想向群组添加超过 100 名成员，则需要重复此步骤。另一种方法是使用 PowerShell 来避免这种情况。

使用 PowerShell 将成员添加到 Microsoft 365 组

我们将展示如何使用 PowerShell 将成员添加到现有 Microsoft 365 组：

将单个成员添加到 Microsoft 365 组
将多个成员添加到单个 Microsoft 365 组
将批量成员添加到单个 Microsoft 365 组
将多个成员添加到所有 Microsoft 365 组
将单个成员添加到所有 Microsoft 365 组

为此，我们需要使用 New-MgGroupMember PowerShell cmdlet。

连接到 Microsoft Graph PowerShell

在开始之前，您必须安装 Microsoft Graph PowerShell 模块。以管理员身份启动 Windows PowerShell 并运行以下命令。

Install-Module Microsoft.Graph -Force

重要提示：在运行 cmdlet 或脚本之前，请务必安装最新的 Microsoft Graph PowerShell 模块版本，以防止出现错误和不正确的结果。

使用以下范围运行 Connect-MgGraph cmdlet 以通过 Microsoft Graph 进行身份验证。

Connect-MgGraph -Scopes "User.ReadWrite.All", "Group.ReadWrite.All", "GroupMember.ReadWrite.All"

现在一切就绪，您可以通过 Microsoft Graph PowerShell 使用这些命令。

将成员添加到 Microsoft 365 组

您可以使用 New-MgGroupMember PowerShell cmdlet 通过 MS Graph PowerShell 将单个或多个成员添加到 Microsoft 365 组。

在我们的示例中，我们将向 Microsoft 365 组（管理团队）添加多个成员。

请参阅将成员添加到 Microsoft 365 组的 PowerShell 语法。

New-MgGroupMember -GroupId "Group Object Id" -DirectoryObjectId "User Object ID"

运行以下 PowerShell 命令将成员添加到 Microsoft 365 组。

New-MgGroupMember -GroupId "031f52ea-cb97-40fc-ab0f-73598f3fc66d" -DirectoryObjectId "41377e9c-dc47-46c0-b4a5-1d5bbdcb5cc5"

将多个成员添加到 Microsoft 365 组

要将多个成员添加到 Microsoft 365 组，您还可以指定 UserPrincipalName 而不是对象 ID。

在脚本顶部键入要添加的用户的 UPN
输入组对象 ID
运行以下 PowerShell 脚本

$upns = @(
    "Amanda.Hansen@m365info.com",
    "Oliver.Taylor@m365info.com",
    "Anna.Bell@m365info.com",
)
$GroupId = "031f52ea-cb97-40fc-ab0f-73598f3fc66d"

$Group = Get-MgGroup -GroupId $GroupId -ErrorAction SilentlyContinue

if ($Group) {

    foreach ($upn in $upns) {
        $User = Get-MgUser -Filter "userPrincipalName eq '$upn'"
        
        if ($User) {
            $UserId = $User.Id
            $ExistingMember = Get-MgGroupMember -GroupId $GroupId
            
            if ($ExistingMember.Id -eq $UserId) {
                Write-Host "User $($User.UserPrincipalName) already exists in the group." -ForegroundColor Yellow
            }
            else {
                New-MgGroupMember -GroupId $GroupId -DirectoryObjectId $UserId
                Write-Host "User $($User.UserPrincipalName) added to the group." -ForegroundColor Green
            }
        }
        else {
            Write-Host "User $upn does not exist." -ForegroundColor Red
        }
    }
}
else {
    Write-Host "Group $GroupId does not exist." -ForegroundColor Red
}

将所有成员批量添加到 Microsoft 365 组

您可以将所有成员添加到单个 Microsoft 365 组。使用 MS Graph PowerShell，您可以一次添加 100 多个成员。

在第 编号 1 行中指定 Microsoft 365 组 ID
运行以下 PowerShell 脚本将所有用户添加到单个 Microsoft 365 组

$GroupId = "031f52ea-cb97-40fc-ab0f-73598f3fc66d"

$Group = Get-MgGroup -GroupId $GroupId -ErrorAction SilentlyContinue

if ($Group) {
    $Users = Get-MgUser -All
    
    foreach ($User in $Users) {
        $ExistingMember = Get-MgGroupMember -GroupId $GroupId
        
        if ($ExistingMember.Id -eq $User.Id) {
            Write-Host "User $($User.UserPrincipalName) already exists in the group." -ForegroundColor Yellow
        }
        else {
            New-MgGroupMember -GroupId $GroupId -DirectoryObjectId $User.Id
            Write-Host "User $($User.UserPrincipalName) added to the group." -ForegroundColor Green
        }
    }
}
else {
    Write-Host "Group $GroupId does not exist." -ForegroundColor Red
}

将特定部门的用户添加到 Microsoft 365 组

在我们的示例中，我们希望将营销部门的所有用户添加到 Microsoft 365 组(ManagementTeam@m365info.com)。

在第 1 行中键入 Microsoft 365 组 ID
运行以下 PowerShell 脚本

$GroupId = "031f52ea-cb97-40fc-ab0f-73598f3fc66d"

$Group = Get-MgGroup -GroupId $GroupId -ErrorAction SilentlyContinue

if ($Group) {
    $Users = Get-MgUser -All -Filter "Department eq 'Marketing'"
    
    foreach ($User in $Users) {
        $ExistingMember = Get-MgGroupMember -GroupId $GroupId
        
        if ($ExistingMember.Id -eq $User.Id) {
            Write-Host "User $($User.UserPrincipalName) already exists in the group." -ForegroundColor Yellow
        }
        else {
            New-MgGroupMember -GroupId $GroupId -DirectoryObjectId $User.Id
            Write-Host "User $($User.UserPrincipalName) added to the group." -ForegroundColor Green
        }
    }
}
else {
    Write-Host "Group $GroupId does not exist." -ForegroundColor Red
}

它将把营销部门的用户添加到 Microsoft 365 组 (ManagementTeam@m365info.com)。

从 CSV 将多个成员添加到 Microsoft 365 组

您可以从 CSV 文件将多个成员添加到单个 Microsoft 365 组。

创建一个包含两列的 CSV 文件：

打开Microsoft Excel
输入 UPN 作为第一列的标题
指定UserPrincipalName
输入 UserID 作为第二列的标题
指定成员对象 ID

如果 (C:) 驱动器中还没有文件夹 temp，请创建该文件夹
将文件命名为 M365users.csv
保存类型为 CSV（逗号分隔 (*.csv)
点击保存

在第 1 行中指定CSV 文件路径
在第 2 行中键入 Microsoft 365 组 ID
运行以下 PowerShell 脚本

$CsvFilePath = "C:\temp\M365users.csv"
$GroupId = "031f52ea-cb97-40fc-ab0f-73598f3fc66d"

$Group = Get-MgGroup -GroupId $GroupId -ErrorAction SilentlyContinue

if ($Group) {
    $CsvUsers = Import-Csv -Path $CsvFilePath

    foreach ($CsvUser in $CsvUsers) {
        $CsvUserID = $CsvUser.UserId
        $User = Get-MgUser -Filter "Id eq '$CsvUserID'" -ErrorAction SilentlyContinue
         
        if ($User) {
            $UserId = $User.Id
            $ExistingMember = Get-MgGroupMember -GroupId $GroupId
               
            if ($ExistingMember.Id -eq $UserId) {
                Write-Host "User $($User.UserPrincipalName) already exists in the group." -ForegroundColor Yellow
            }
            else {
                New-MgGroupMember -GroupId $GroupId -DirectoryObjectId $UserId
                Write-Host "User $($User.UserPrincipalName) added to the group." -ForegroundColor Green
            }
        }
        else {
            Write-Host "User $CsvUserID does not exist." -ForegroundColor Red
        }
    }
}
else {
    Write-Host "Group $GroupId does not exist." -ForegroundColor Red
}

PowerShell 输出结果显示是否：

Microsoft 365 组不存在或拼写错误
用户已经是 Microsoft 365 组的成员
用户已添加到 Microsoft 365 组
用户不存在或拼写错误

从 CSV 将成员添加到多个 Microsoft 365 组

您可以从 CSV 文件将现有用户添加到多个 Microsoft 365 组。您需要创建一个包含两列的 CSV 文件。前两列将包含 Microsoft 365 组的列表。第三列和第四列将包含您要添加为成员的用户列表。

创建一个包含四列的 CSV 文件：

打开Microsoft Excel
输入 GroupName 作为第一列的标题
指定 Microsoft 365 组电子邮件
输入 GroupID 作为第二列的标题
指定 Microsoft 365组 ID
输入用户名作为第三列的标题
指定成员UserPrincipalName
输入 MemberId 作为第四列的标题
指定成员对象 ID

请参阅下面的 CSV 文件示例。

如果 (C:) 驱动器中还没有文件夹 temp，请创建该文件夹
将文件命名为 M365members.csv
保存类型为 CSV（逗号分隔 (*.csv)
点击保存

在第 1 行中指定CSV 文件路径
运行以下 PowerShell 脚本

$CsvFilePath = "C:\temp\M365members.csv"

$Csv = Import-Csv $CsvFilePath

foreach ($row in $Csv) {
    $GroupId = $Row.GroupId
    $MemberId = $Row.MemberId

    $Group = Get-MgGroup -GroupId $GroupId -ErrorAction SilentlyContinue

    if ($Group) {
        $ExistingMember = Get-MgGroupMember -GroupId $GroupId
    
        if ($ExistingMember.Id -eq $MemberId) {
            Write-Host "User $MemberId already exists in the group." -ForegroundColor Yellow
        }
        else {
            $User = Get-MgUser -Filter "Id eq '$MemberId'" -ErrorAction SilentlyContinue
    
            if ($User) {
                New-MgGroupMember -GroupId $GroupId -DirectoryObjectId $MemberId
                Write-Host "User $MemberId added to the group." -ForegroundColor Green 
            }
            else {
                Write-Host "User $MemberId doesn't exist" -ForegroundColor Red
            }
        }
    }
    else {
        Write-Host "Group $GroupId does not exist." -ForegroundColor Red
    }
}

PowerShell 输出结果显示是否：

Microsoft 365 组不存在或拼写错误
用户已经是 Microsoft 365 组的成员
用户已添加到 Microsoft 365 组
用户不存在或拼写错误

从 CSV 将单个用户添加到所有 Microsoft 365 组

要将用户添加到多个 Microsoft 365 组，您需要创建 CSV 文件。

在我们的示例中，我们希望将用户（Amanda Hansen）添加到多个 Microsoft 365 组。