Add-AzADAppPermission

リファレンス

モジュール:: Az.Resources

API アクセス許可を追加します。

構文

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>]

説明

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に-Type対応しますRole。プロパティの下の委任されたアクセス許可は、次oauth2Permissionsに対応しますScope-Type。

Azure PowerShell ではまだサポートされていないため、アクセス許可に管理者の同意が必要な場合は、ユーザーが Azure Portal 経由で同意を付与する必要があります。

例

例 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

アプリケーション ID。

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

-Confirm

コマンドレットの実行前に確認を求めるメッセージが表示されます。

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

Microsoft Entra ID の一意識別子。

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

-PermissionId

リソースアプリケーションが公開する oauth2PermissionScopes または appRole インスタンスの 1 つの一意識別子。

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

-Type

id プロパティが 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

コマンドレットの実行時に発生する内容を示します。このコマンドレットは実行されません。

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

出力

Boolean

メモ

別名