Compartilhar via

New-AzureADUserAppRoleAssignment

  • Referência
Módulo:
AzureADPreview

Atribui um usuário a uma função de aplicativo.

Sintaxe

New-AzureADUserAppRoleAssignment
   -ObjectId <String>
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   -Id <String>
   -PrincipalId <String>
   -ResourceId <String>
   [<CommonParameters>]

Description

O cmdlet New-AzureADUserAppRoleAssignment atribui um usuário a uma função de aplicativo no Azure Active Directory (AD).

Exemplos

Exemplo 1: Atribuir um usuário a um aplicativo sem funções

# Get AppId of the app to assign the user to

$appId = Get-AzureADApplication -SearchString "<Your App's display name>"

# Get the user to be added

$user = Get-AzureADUser -searchstring "<Your user's UPN>"

# Get the service principal for the app you want to assign the user to

$servicePrincipal = Get-AzureADServicePrincipal -Filter "appId eq 'appId'"

# Create the user app role assignment

New-AzureADUserAppRoleAssignment -ObjectId $user.ObjectId -PrincipalId $user.ObjectId -ResourceId $servicePrincipal.ObjectId -Id ([Guid]::Empty)

Esse comando atribui um usuário a um aplicativo e que o faz; não tem funções.

Exemplo 2: Atribuir um usuário a uma função específica dentro de um aplicativo

$username = "<You user's UPN>"
$appname = "<Your App's display name>"
$spo = Get-AzureADServicePrincipal -Filter "Displayname eq '$appname'"
$user = Get-AzureADUser -ObjectId $username
New-AzureADUserAppRoleAssignment -ObjectId $user.ObjectId -PrincipalId $user.ObjectId -ResourceId $spo.ObjectId -Id $spo.Approles[1].id

Esse cmdlet atribui ao usuário especificado a função de aplicativo da qual a ID é especificada com $spo. Approles[1].id. Consulte a descrição do parâmetro -Id para obter mais informações sobre como recuperar funções de aplicativo para um aplicativo.

Parâmetros

-Id

A ID da função de aplicativo a ser atribuída. Forneça um guid vazio ao criar uma atribuição de função de aplicativo para um aplicativo que não tenha nenhuma função ou a ID da função a ser atribuída ao usuário.

Você pode recuperar as funções do aplicativo examinando a propriedade AppRoles do objeto de aplicativo:

Get-AzureadApplication -SearchString "Your Application display name" | select Approles | Fl

Esse cmdlet retorna a lista de funções definidas em um aplicativo:

AppRoles : {class AppRole {
         AllowedMemberTypes: System.Collections.Generic.List1[System.String]
         Description: <description for this role>
         DisplayName: <display name for this role>
         Id: 97e244a2-6ccd-4312-9de6-ecb21884c9f7
         IsEnabled: True
         Value: <Value that will be transmitted as a claim in a token for this role>
       }
       }
Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-InformationAction

Especifica como esse cmdlet responde a um evento de informações. Os valores aceitáveis para esse parâmetro são:

  • Continuar
  • Ignorar
  • Consultar
  • SilentlyContinue
  • Stop
  • Suspend
Tipo:ActionPreference
Aliases:infa
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-InformationVariable

Especifica uma variável de informações.

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

-ObjectId

Especifica a ID do usuário (como um UPN ou ObjectId) no Azure AD ao qual a nova função de aplicativo deve ser atribuída

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

-PrincipalId

A ID do objeto da entidade de segurança à qual a nova função de aplicativo é atribuída. Ao atribuir uma nova função a um usuário, forneça a ID do objeto do usuário.

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

-ResourceId

A ID do objeto da Entidade de Serviço para o aplicativo ao qual a função de usuário é atribuída.

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