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) を指定します。

このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、about_CommonParametersを参照してください。