Compartilhar via


Add-AzADAppPermission

Adiciona uma permissão de API.

Sintaxe

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

Adiciona uma permissão de API. A lista de permissões disponíveis da API é propriedade do aplicativo representada pela entidade de serviço no locatário.

Por exemplo, para obter permissões disponíveis para a API do Graph:

  • Grafo do Azure Active Directory: Get-AzAdServicePrincipal -ApplicationId 00000002-0000-0000-c000-000000000000
  • Microsoft Graph: Get-AzAdServicePrincipal -ApplicationId 00000003-0000-0000-c000-000000000000

As permissões de appRoles aplicativo na propriedade correspondem a Role in -Type. As permissões delegadas na oauth2Permissions propriedade correspondem a Scope in -Type.

O usuário precisará conceder consentimento por meio do Portal do Azure se a permissão exigir o consentimento do administrador porque o Azure PowerShell ainda não dá suporte a ele.

Exemplos

Exemplo 1: Adicionar permissão de API

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

Adicionar permissão delegada "Group.Read.All" da API do Microsoft Graph ao aplicativo do AD (9cc74d5e-1162-4b90-8696-65f3d6a3f7d0)

Exemplo 2: Adicionar permissão de API

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

Adicionar permissão de aplicativo "Device.ReadWrite.All" da API do Microsoft Graph ao aplicativo AD (9cc74d5e-1162-4b90-8696-65f3d6a3f7d0)

Parâmetros

-ApiId

O identificador exclusivo para o recurso que o aplicativo requer acesso. Isso deve ser igual ao appId declarado no aplicativo de recurso de destino.

Tipo:Guid
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ApplicationId

O ID do aplicativo.

Tipo:Guid
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Confirm

Solicita sua confirmação antes de executar o cmdlet.

Tipo:SwitchParameter
Aliases:cf
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DefaultProfile

As credenciais, a conta, o locatário e a assinatura usados para a comunicação com o Azure.

Tipo:PSObject
Aliases:AzContext, AzureRmContext, AzureCredential
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ObjectId

O identificador exclusivo no Azure AD.

Tipo:Guid
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-PermissionId

O identificador exclusivo para uma das instâncias oauth2PermissionScopes ou appRole que o aplicativo de recurso expõe.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Type

Especifica se a propriedade id faz referência a um oauth2PermissionScopes(Scope, permissão delegada) ou a um appRole(Role, permissão de aplicativo).

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Tipo:SwitchParameter
Aliases:wi
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Saídas

Boolean

Observações

ALIASES