Remove-EntraUserAppRoleAssignment

Módulo:
Microsoft.Entra.Users Module v1.3

Remove uma atribuição de função de aplicativo de usuário.

Sintaxe

Default (Default) 

Remove-EntraUserAppRoleAssignment

    -AppRoleAssignmentId <String>
    -UserId <String>
    [<CommonParameters>]

Description

O Remove-EntraUserAppRoleAssignment cmdlet remove uma atribuição de função de aplicativo de usuário em Microsoft Entra ID.

Em cenários delegados com contas corporativas ou de estudante, o usuário conectado deve ter uma função de Microsoft Entra com suporte ou uma função personalizada com as permissões necessárias. As funções suportadas incluem:

  • Contas de sincronização de diretório (para Entra Connect e Cloud Sync)
  • Editor de Diretórios
  • Administrador de identidade híbrida
  • Administrador de gestão de identidade
  • Administrador de Função Privilégiada
  • Administrador de usuários
  • Administrador de Aplicativos
  • Administrador de Aplicativos na Nuvem

Exemplos

Exemplo 1: remover a atribuição de função do aplicativo de usuário

Connect-Entra -Scopes 'AppRoleAssignment.ReadWrite.All'
$assignment = Get-EntraUserAppRoleAssignment -UserId 'SawyerM@Contoso.com' |
Where-Object { $_.ResourceDisplayName -eq 'Helpdesk Application' -and $_.PrincipalType -eq 'User' }
Remove-EntraUserAppRoleAssignment -UserId 'SawyerM@Contoso.com' -AppRoleAssignmentId $assignment.Id

Este exemplo demonstra como remover a atribuição de função do aplicativo de usuário em Microsoft Entra ID.

  • -UserId o parâmetro especifica a ID do usuário.
  • -AppRoleAssignmentId o parâmetro especifica a ID da atribuição de função do aplicativo.

Use o Get-EntraUserAppRoleAssignment cmdlet para obter AppRoleAssignmentId detalhes.

Parâmetros

-AppRoleAssignmentId

Especifica a ID de uma atribuição de função de aplicativo.

Propriedades do parâmetro

Tipo:System.String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:True
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-UserId

Especifica a ID (como UserPrincipleName ou ObjectId) de um usuário no Microsoft Entra ID.

Propriedades do parâmetro

Tipo:System.String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:IdentificadorDeObjeto, UPN, Identidade, Nome Principal do Usuário

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:True
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.