New-EntraGroupAppRoleAssignment

モジュール:
Microsoft.Entra.Groups Module v1.3

ユーザーのグループをアプリケーション ロールに割り当てます。

構文

Default (既定) 

New-EntraGroupAppRoleAssignment

    -GroupId <String>
    -PrincipalId <String>
    -AppRoleId <String>
    -ResourceId <String>
    [<CommonParameters>]

説明

New-EntraGroupAppRoleAssignment コマンドレットは、Microsoft Entra IDのアプリケーション ロールにユーザーのグループを割り当てます。

例

例 1: アプリケーションにユーザーのグループを割り当てる

Connect-Entra -Scopes 'AppRoleAssignment.ReadWrite.All'
$servicePrincipal = Get-EntraServicePrincipal -Filter "Displayname eq 'Box'"
$group = Get-EntraGroup -SearchString 'Contoso Global'
New-EntraGroupAppRoleAssignment -GroupId $group.Id -PrincipalId $group.Id -ResourceId $servicePrincipal.Id -AppRoleId $servicePrincipal.Approles[1].Id

DeletedDateTime        Id                                          AppRoleId                            CreatedDateTime      PrincipalDisplayName PrincipalId
---------------        --                                          ---------                            ---------------      -------------------- -----------
                      AaBbCcDdEeFfGgHhIiJjKkLlMmNnOo1 00000000-0000-0000-0000-000000000000 3/13/2024 4:41:43 AM Contoso Team         aaaaaaaa-bbbb-cccc-1111-222222222222
3/13/2024 4:45:00 AM  BbCcDdEeFfGgHhIiJjKkLlMmNnOoPp2 00000000-0000-0000-0000-000000000000 3/13/2024 4:45:00 AM Finance Group        bbbbbbbb-cccc-dddd-2222-333333333333

この例では、Microsoft Entra IDでユーザーのグループをアプリケーション ロールに割り当てる方法を示します。

  • GroupId: アプリ ロールを割り当てるグループの ID。
  • PrincipalId: アプリ ロールを割り当てるグループの ID。
  • ResourceId: アプリ ロールを定義したリソース サービス プリンシパルの ID。
  • AppRoleId: グループに割り当てる appRole (リソース サービス プリンシパルで定義) の ID。

パラメーター

-AppRoleId

割り当てるアプリ ロール (リソース サービス プリンシパルで定義) の ID を指定します。

パラメーターのプロパティ

型:System.String
規定値:None
ワイルドカードのサポート:False
DontShow:False
Aliases:Id

パラメーター セット

(All)
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-GroupId

Microsoft Entra ID内のグループの ID を指定します。

パラメーターのプロパティ

型:System.String
規定値:None
ワイルドカードのサポート:False
DontShow:False
Aliases:オブジェクト識別子

パラメーター セット

(All)
配置:Named
必須:True
パイプラインからの値:True
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False

-PrincipalId

プリンシパル ID を指定します。

パラメーターのプロパティ

型:System.String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-ResourceId

割り当てが行われるリソース サービス プリンシパルの一意識別子 (ID)。 作成時に必要です。 $filterをサポートします (eq のみ)。

パラメーターのプロパティ

型:System.String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

CommonParameters

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