Add-AzADAppPermission

參考

模組:: Az.Resources

新增 API 許可權。

Syntax

Add-AzADAppPermission
   -ApiId <Guid>
   -PermissionId <String>
   -ObjectId <Guid>
   [-Type <String>]
   [-DefaultProfile <PSObject>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Add-AzADAppPermission
   -ApiId <Guid>
   -PermissionId <String>
   [-Type <String>]
   -ApplicationId <Guid>
   [-DefaultProfile <PSObject>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

新增 API 許可權。 API 的可用許可權清單是租用戶中服務主體所代表之應用程式的屬性。

例如，若要取得 Graph API 的可用權限：

Azure Active Directory Graph： Get-AzAdServicePrincipal -ApplicationId 00000002-0000-0000-c000-000000000000
Microsoft Graph：Get-AzAdServicePrincipal -ApplicationId 00000003-0000-0000-c000-000000000000

屬性下 appRoles 的應用程式權限會對應至 Role 中的 -Type。屬性下的 oauth2Permissions 委派權限會對應至 Scope 中的 -Type。

如果使用者需要系統管理員同意，用戶必須透過 Azure 入口網站授與同意，因為 Azure PowerShell 尚不支援它。

範例

範例 1：新增 API 許可權

Add-AzADAppPermission -ObjectId 9cc74d5e-1162-4b90-8696-65f3d6a3f7d0 -ApiId 00000003-0000-0000-c000-000000000000 -PermissionId 5f8c59db-677d-491f-a6b8-5f174b11ec1d

將 Microsoft Graph API 的委派許可權 “Group.Read.All” 新增至 AD 應用程式（9cc74d5e-1162-4b90-8696-65f3d6a3f7d0）

範例 2：新增 API 許可權

Add-AzADAppPermission -ObjectId 9cc74d5e-1162-4b90-8696-65f3d6a3f7d0 -ApiId 00000003-0000-0000-c000-000000000000 -PermissionId 1138cb37-bd11-4084-a2b7-9f71582aeddb -Type Role

將 Microsoft Graph API 的應用程式許可權 “Device.ReadWrite.All” 新增至 AD 應用程式（9cc74d5e-1162-4b90-8696-65f3d6a3f7d0）

參數

-ApiId

應用程式需要存取之資源的唯一標識符。這應該等於目標資源應用程式上宣告的appId。

Type:	Guid
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-ApplicationId

應用程式識別碼。

Type:	Guid
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

執行 Cmdlet 之前先提示您確認。

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DefaultProfile

用於與 Azure 通訊的認證、帳戶、租用戶和訂用帳戶。

Type:	PSObject
Aliases:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ObjectId

Azure AD 中的唯一標識符。

Type:	Guid
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-PermissionId

資源應用程式公開的其中一個 oauth2PermissionScopes 或 appRole 實例的唯一標識符。

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Type

指定識別符屬性參考 oauth2PermissionScopes（Scope， delegated permission）或 appRole（Role， application permission）。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

顯示執行 Cmdlet 後會發生的情況。未執行 Cmdlet。

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

輸出

Boolean

備註

別名