Add-EntraGroupMember

Add-EntraGroupMember

    -GroupId <String>
    -MemberId <String>
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

该 Add-EntraGroupMember cmdlet 将成员添加到安全组或Microsoft 365组。

New-EntraGroupMember 并且 Add-EntraGroupMembership 是 . 的 Add-EntraGroupMember别名。

在委派方案中，登录用户需要受支持的Microsoft Entra角色或具有权限的microsoft.directory/groups/members/update自定义角色。 此操作所需的最低角色（不包括可分配角色的组）包括：

• 组所有者
• 目录编写人员
• 群组管理员
• 用户管理员

Connect-Entra -Scopes 'GroupMember.ReadWrite.All'
$group = Get-EntraGroup -Filter "DisplayName eq 'Contoso Marketing Group'"
$user = Get-EntraUser -UserId 'SawyerM@contoso.com'
Add-EntraGroupMember -GroupId $group.Id -MemberId $user.Id

此示例演示如何将成员添加到组。

• -GroupId - 指定要向其添加成员的组的唯一标识符（对象 ID）。
• -MemberId - 指定要添加到组的成员的唯一标识符（对象 ID）。 可以将用户、安全组、Microsoft 365组、设备、服务主体和组织联系人添加到安全组。 只能将用户添加到Microsoft 365组。

Connect-Entra -Scopes 'GroupMember.ReadWrite.All'
$group = Get-EntraGroup -Filter "DisplayName eq 'Sales and Marketing'"
Get-EntraUser -Filter "startsWith(displayName,'Updated User')" |
    Add-EntraGroupMember -GroupId $group.Id

此示例演示如何基于搜索结果向组添加成员。

• -GroupId - 指定要向其添加成员的组的唯一标识符（对象 ID）。

Connect-Entra -Scopes 'GroupMember.ReadWrite.All'
$group = Get-EntraGroup -Filter "DisplayName eq 'Sales and Marketing'"
Get-EntraGroupMember -GroupId "source-group-id" |
    Add-EntraGroupMember -GroupId $group.Id

此示例演示如何将组成员从源目标组同步到新组。

• -GroupId - 指定要向其添加成员的组的唯一标识符（对象 ID）。

此 cmdlet 支持通用参数：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息，请参阅 about_CommonParameters。