New-EntraDirectoryRoleAssignment

New-EntraDirectoryRoleAssignment

    -PrincipalId <String>
    -RoleDefinitionId <String>
    [-DirectoryScopeId <String>]
    [<CommonParameters>]

New-EntraDirectoryRoleAssignment コマンドレットは、新しいMicrosoft Entraロールの割り当てを作成します。

委任されたシナリオでは、サインインしているユーザーには、サポートされているMicrosoft Entraロールまたは必要なアクセス許可を持つカスタム ロールが必要です。 この操作に必要な最小ロールは次のとおりです。

• 特権ロール管理者

Connect-Entra -Scopes 'RoleManagement.ReadWrite.Directory', 'EntitlementManagement.ReadWrite.All'
$user = Get-EntraUser -UserId 'SawyerM@contoso.com'
$role = Get-EntraDirectoryRoleDefinition -Filter "DisplayName eq 'Helpdesk Administrator'"
New-EntraDirectoryRoleAssignment -RoleDefinitionId $role.Id -PrincipalId $user.Id -DirectoryScopeId '/'

Id                                            PrincipalId                          RoleDefinitionId                     DirectoryScopeId AppScopeId
--                                            -----------                          ----------------                     ---------------- ----------
A1bC2dE3fH4iJ5kL6mN7oP8qR9sT0u aaaaaaaa-bbbb-cccc-1111-222222222222 a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1 /

このコマンドは、Microsoft Entra IDで新しいロールの割り当てを作成します。

• -RoleDefinitionId パラメーターは、割り当てるロール定義の ID を指定します。 ロール定義は、ロールによってユーザーまたはグループに付与されるアクセス許可を表します。 これは、割り当ての対象となる unifiedRoleDefinition の識別子です。
• -PrincipalId パラメーターは、ロールが割り当てられているプリンシパル (ユーザー、グループ、またはサービス プリンシパル) の ID を指定します。
• -DirectoryScopeId パラメーターは、ロールの割り当てが有効なディレクトリのスコープを指定します。 通常、'/' 値はルート スコープを表します。つまり、ロールの割り当てはディレクトリ全体に適用できます。

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

New-EntraRoleAssignment は New-EntraDirectoryRoleAssignment の別名です。