Add-EntraGroupMember

Add-EntraGroupMember

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

指令Add-EntraGroupMember長會將成員加入安全或 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。