New-AzureADUserAppRoleAssignment

Sintaxe

Default (Predefinição)

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

Description

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)

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

Parâmetros

-Id

A ID da função do aplicativo a ser atribuída. Forneça um guid vazio ao criar uma nova 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 do aplicativo:

Get-AzureadApplication -SearchString "Seu nome de exibição do aplicativo" | selecione Approles | Fl

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

AppRoles : {class AppRole { AllowedMemberTypes: System.Collections.Generic.List1[System.String] Descrição: <descrição desta função> DisplayName: <nome de exibição para esta função> Id: 97e244a2-6ccd-4312-9de6-ecb21884c9f7 IsEnabled: True Value: <Valor que será transmitido como uma declaração em um token para esta função> } }

Propriedades dos parâmetros

Conjuntos de parâmetros

-InformationAction

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

• Continuar
• Ignorar
• Pergunte
• Continuar em Silêncio
• Parar
• Suspender

Propriedades dos parâmetros

Conjuntos de parâmetros

-InformationVariable

Especifica uma variável de informação.

Propriedades dos parâmetros

Conjuntos de parâmetros

-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

Propriedades dos parâmetros

Conjuntos de parâmetros

-PrincipalId

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

Propriedades dos parâmetros

Conjuntos de parâmetros

-ResourceId

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

Propriedades dos parâmetros

Conjuntos de parâmetros

CommonParameters

Notas

Ligações Relacionadas

• Get-AzureADUserAppRoleAssignment
• Remove-AzureADUserAppRoleAssignment