Get-AzureADUser

  • Referência
Módulo:
AzureAD

Obtém um utilizador.

Syntax

Get-AzureADUser
   [-All <Boolean>]
   [-Top <Int32>]
   [-Filter <String>]
   [<CommonParameters>]
Get-AzureADUser
   [-SearchString <String>]
   [-All <Boolean>]
   [<CommonParameters>]
Get-AzureADUser
   -ObjectId <String>
   [-All <Boolean>]
   [<CommonParameters>]

Description

O cmdlet Get-AzureADUser obtém um utilizador a partir do ID de Microsoft Entra.

Exemplos

Exemplo 1: Obter os dez principais utilizadores

PS C:\>Get-AzureADUser -Top 10

Este comando obtém 10 utilizadores.

Exemplo 2: Obter um utilizador por ID

PS C:\>Get-AzureADUser -ObjectId "testUpn@tenant.com"

Este comando obtém o utilizador especificado.

Exemplo 3: procurar entre utilizadores obtidos

PS C:\> Get-AzureADUser -SearchString "New"

ObjectId                             DisplayName UserPrincipalName                   UserType
--------                             ----------- -----------------                   --------
5e8b0f4d-2cd4-4e17-9467-b0f6a5c0c4d0 New user    NewUser@contoso.onmicrosoft.com     Member
2b450b8e-1db6-42cb-a545-1b05eb8a358b New user    NewTestUser@contoso.onmicrosoft.com Member

Este cmdlet obtém todos os utilizadores que correspondem ao valor de SearchString em relação aos primeiros carateres em DisplayName ou UserPrincipalName.

Exemplo 4: Obter um utilizador por userPrincipalName

PS C:\>Get-AzureADUser -Filter "userPrincipalName eq 'jondoe@contoso.com'"

Este comando obtém o utilizador especificado.

Exemplo 5: Obter um utilizador por JobTitle

PS C:\>Get-AzureADUser -Filter "startswith(JobTitle,'Sales')"

Este comando obtém todos os utilizadores cujo cargo começa com vendas, por exemplo, Gestor de Vendas e Assistente de Vendas.

Parâmetros

-All

Se for verdadeiro, devolva todos os utilizadores. Se for falso, devolva o número de objetos especificados pelo parâmetro Superior

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

-Filter

Especifica uma instrução de filtro OData v3.0. Este parâmetro controla os objetos que são devolvidos. Pode encontrar detalhes sobre a consulta com OData aqui. http://www.odata.org/documentation/odata-version-3-0/odata-version-3-0-core-protocol/#queryingcollections. Nem todas as funções e operadores OData v3.0 são suportados neste momento.

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

-ObjectId

Especifica o ID (como UM UPN ou ObjectId) de um utilizador no Microsoft Entra ID.

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

-SearchString

Especifica uma cadeia de pesquisa.

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

-Top

Especifica o número máximo de registos a devolver.

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

Notas

Veja o guia de migração de Get-AzureADUser para o Microsoft Graph PowerShell.