New-EntraServicePrincipalAppRoleAssignment

指派服務主體到應用程式角色。

語法

Default (預設值)

New-EntraServicePrincipalAppRoleAssignment

    -ServicePrincipalId <String>
    -PrincipalId <String>
    -Id <String>
    -ResourceId <String>
    [<CommonParameters>]

Description

New-EntraServicePrincipalAppRoleAssignment指令小程式會在 Microsoft Entra ID 中指派一個服務主體給應用程式角色。

對於委派情境,呼叫使用者至少需要以下一項 Microsoft Entra 角色。

  • 目錄同步帳號
  • 目錄創建者
  • 混合式身分識別管理員
  • 身分識別控管系統管理員
  • 特殊權限角色管理員
  • 使用者管理員
  • 應用程式管理員
  • 雲端應用程式管理員

範例

範例 1:將應用程式角色指派給服務主體

Connect-Entra -Scopes 'AppRoleAssignment.ReadWrite.All'
$clientServicePrincipal = Get-EntraServicePrincipal -Filter "displayName eq 'Helpdesk Application'"
$resourceServicePrincipal = Get-EntraServicePrincipal -Filter "displayName eq 'Microsoft Graph'"
$appRole = $resourceServicePrincipal.AppRoles | Where-Object { $_.Value -eq "User.ReadBasic.All" }

New-EntraServicePrincipalAppRoleAssignment -ServicePrincipalId $clientServicePrincipal.Id -PrincipalId $clientServicePrincipal.Id -Id $appRole.Id -ResourceId $resourceServicePrincipal.Id

範例 2:將應用程式角色指派給另一位服務主體

Connect-Entra -Scopes 'AppRoleAssignment.ReadWrite.All'
$clientServicePrincipal = Get-EntraServicePrincipal -Filter "displayName eq 'Helpdesk Application'"
$servicePrincipalObject = Get-EntraServicePrincipal -Filter "displayName eq 'Box'"
New-EntraServicePrincipalAppRoleAssignment -ServicePrincipalId $clientServicePrincipal.Id -PrincipalId $clientServicePrincipal.Id -ResourceId $servicePrincipalObject.Id -Id $servicePrincipalObject.Approles[1].Id
Id                                          AppRoleId                            CreationTimestamp   PrincipalDisplayName PrincipalId                          PrincipalType    ResourceDisplayName ResourceId
--                                          ---------                            -----------------   -------------------- -----------                          -------------    ------------------- ----------
1aaaaaa1-2bb2-3cc3-4dd4-5eeeeeeeeee5 00000000-0000-0000-0000-000000000000 12-03-2024 11:05:29 Box                  aaaaaaaa-bbbb-cccc-1111-222222222222 ServicePrincipal Box                 aaaa0000-bb11-2222-33cc-444444dddddd

此範例示範如何在 Microsoft Entra ID 中將應用程式角色指派給另一個服務主體。 你可以用這個指令 Get-EntraServicePrincipal 取得服務負責人的 ID。

  • -ServicePrincipalId 參數指定你指派應用程式角色的客戶端服務主體的 ObjectId。
  • -ResourceId參數指定資源服務主體的 ObjectId。
  • -Id 參數指定應用程式角色的 ID(定義於資源服務主體上),指派給客戶端服務主體。 如果資源應用程式沒有定義應用程式角色,你可以使用 00000000-0000-0000-0000-000000000000。
  • -PrincipalId 參數指定你指派應用程式角色的客戶端服務主體的 ObjectId。

範例 3:指派應用程式角色給使用者

Connect-Entra -Scopes 'AppRoleAssignment.ReadWrite.All'
$servicePrincipalObject = Get-EntraServicePrincipal -Filter "displayName eq 'Box'"
$user = Get-EntraUser -UserId 'PattiF@Contoso.com'

New-EntraServicePrincipalAppRoleAssignment `
    -ServicePrincipalId $servicePrincipalObject.Id `
    -ResourceId $servicePrincipalObject.Id `
    -Id $servicePrincipalObject.Approles[1].Id `
    -PrincipalId $user.Id
Id                                          AppRoleId                            CreationTimestamp   PrincipalDisplayName PrincipalId                          PrincipalType    ResourceDisplayName ResourceId
--                                          ---------                            -----------------   -------------------- -----------                          -------------    ------------------- ----------
2bbbbbb2-3cc3-4dd4-5ee5-6ffffffffff6 00000000-0000-0000-0000-000000000000 12-03-2024 11:05:29 Box                  aaaaaaaa-bbbb-cccc-1111-222222222222 ServicePrincipal Box                 bbbb1111-cc22-3333-44dd-555555eeeeee

此範例示範如何在 Microsoft Entra ID 中為使用者指派應用程式角色。 你可以用這個指令 Get-EntraServicePrincipal 取得服務負責人的 ID。你可以用這個指令 Get-EntraUser 取得使用者 ID。

  • -ServicePrincipalId 參數指定應用程式服務主體的 ObjectId。
  • -ResourceId參數指定應用程式服務主體的 ObjectId。
  • -Id 參數指定應用程式角色的 ID(定義於應用程式的服務主體上)並指派給使用者。 如果資源應用程式沒有定義應用程式角色,你可以用來 00000000-0000-0000-0000-000000000000 表示該應用程式已被指派給使用者。
  • -PrincipalId 參數指定你指派應用程式角色的使用者的 ObjectId。

範例 4:將應用程式角色指派給一個群組

Connect-Entra -Scopes 'AppRoleAssignment.ReadWrite.All'
$servicePrincipalObject = Get-EntraServicePrincipal -Filter "displayName eq 'Box'"
$group = Get-EntraGroup -Filter "displayName eq 'Contoso marketing'"

New-EntraServicePrincipalAppRoleAssignment `
    -ServicePrincipalId $servicePrincipalObject.Id `
    -ResourceId $servicePrincipalObject.Id `
    -Id $servicePrincipalObject.Approles[1].Id `
    -PrincipalId $group.Id
Id                                          AppRoleId                            CreationTimestamp   PrincipalDisplayName PrincipalId                          PrincipalType    ResourceDisplayName ResourceId
--                                          ---------                            -----------------   -------------------- -----------                          -------------    ------------------- ----------
3cccccc3-4dd4-5ee5-6ff6-7aaaaaaaaaa7 00000000-0000-0000-0000-000000000000 12-03-2024 11:05:29 Box                  aaaaaaaa-bbbb-cccc-1111-222222222222 ServicePrincipal Box                 cccc2222-dd33-4444-55ee-666666ffffff

此範例示範如何在 Microsoft Entra ID 中將應用程式角色指派給群組。 你可以用這個指令 Get-EntraServicePrincipal 取得服務負責人的 ID。你可以用這個指令 Get-EntraGroup 取得群組 ID。

  • -ServicePrincipalId 參數指定應用程式服務主體的 ObjectId。
  • -ResourceId參數指定應用程式服務主體的 ObjectId。
  • -Id 參數指定應用程式角色的 ID(定義於應用程式的服務主體上),以指派給群組。 如果資源應用程式沒有定義應用程式角色,你可以用來 00000000-0000-0000-0000-000000000000 表示該應用程式已被指派到該群組。
  • -PrincipalId 參數指定你指派應用程式角色的群組的 ObjectId。

參數

-Id

指定識別碼。

參數屬性

類型:System.String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:True
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-PrincipalId

指定主要識別碼。

參數屬性

類型:System.String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:True
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-ResourceId

指定資源 ID。

參數屬性

類型:System.String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:True
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-ServicePrincipalId

指定 Microsoft Entra ID 中服務主體的 ID。

參數屬性

類型:System.String
預設值:None
支援萬用字元:False
不要顯示:False
別名:ObjectId (物件識別碼)

參數集

(All)
Position:Named
必要:True
來自管線的值:True
來自管線按屬性名稱的值:True
來自剩餘引數的值:False

CommonParameters

此 Cmdlet 支援一般參數:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊,請參閱 about_CommonParameters。

備註

New-EntraServiceAppRoleAssignment 是 New-EntraServicePrincipalAppRoleAssignment 的別名。