Compartilhar via

Get-AzureADUser

  • Referência
Módulo:
AzureADPreview

Obtém um usuário.

Sintaxe

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 usuário do Azure Active Directory (AD).

Exemplos

Exemplo 1: Obter dez usuários

PS C:\>Get-AzureADUser -Top 10

Esse comando obtém dez usuários.

Exemplo 2: Obter um usuário por ID

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

Esse comando obtém o usuário especificado.

Exemplo 3: pesquisar entre usuários recuperados

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

Esse cmdlet obtém todos os usuários que correspondem ao valor de SearchString em relação aos primeiros caracteres em DisplayName ou UserPrincipalName .

Exemplo 4: Obter um usuário por userPrincipalName

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

Esse comando obtém o usuário especificado.

Exemplo 5: Obter um usuário por userPrincipalName

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

Esse comando obtém todos os usuários que o título começa com vendas. Ou seja, Gerente de Vendas e Assistente de Vendas.

Parâmetros

-All

Se for true, retorne todos os usuários. Se for false, retorne o número de objetos especificados pelo parâmetro Top

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

-Filter

Especifica uma instrução de filtro oData v3.0. Esse parâmetro controla quais objetos são retornados. Detalhes sobre a consulta com oData podem ser encontrados aqui. http://www.odata.org/documentation/odata-version-3-0/odata-version-3-0-core-protocol/#queryingcollections

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

-ObjectId

Especifica a ID (como um UPN ou ObjectId) de um usuário no Azure AD.

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

-SearchString

Especifica uma cadeia de caracteres de pesquisa.

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

-Top

Especifica o número máximo de registros a serem retornados.

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