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 的別名。