Compartilhar via


Get-MsolUser

Obtém usuários do Azure Active Directory.

Sintaxe

Get-MsolUser
   [-ReturnDeletedUsers]
   [-City <String>]
   [-Country <String>]
   [-Department <String>]
   [-DomainName <String>]
   [-EnabledFilter <UserEnabledFilter>]
   [-State <String>]
   [-Synchronized]
   [-Title <String>]
   [-HasErrorsOnly]
   [-LicenseReconciliationNeededOnly]
   [-UnlicensedUsersOnly]
   [-UsageLocation <String>]
   [-SearchString <String>]
   [-MaxResults <Int32>]
   [-TenantId <Guid>]
   [<CommonParameters>]
Get-MsolUser
   -ObjectId <Guid>
   [-ReturnDeletedUsers]
   [-TenantId <Guid>]
   [<CommonParameters>]
Get-MsolUser
   [-ReturnDeletedUsers]
   -UserPrincipalName <String>
   [-TenantId <Guid>]
   [<CommonParameters>]
Get-MsolUser
   [-ReturnDeletedUsers]
   [-City <String>]
   [-Country <String>]
   [-Department <String>]
   [-DomainName <String>]
   [-EnabledFilter <UserEnabledFilter>]
   [-State <String>]
   [-Synchronized]
   [-Title <String>]
   [-HasErrorsOnly]
   [-LicenseReconciliationNeededOnly]
   [-UnlicensedUsersOnly]
   [-UsageLocation <String>]
   [-SearchString <String>]
   [-All]
   [-TenantId <Guid>]
   [<CommonParameters>]

Description

O cmdlet Get-MsolUser obtém um usuário individual ou uma lista de usuários. Especifique o parâmetro ObjectId ou UserPrincipalName para obter um usuário específico.

Exemplos

Exemplo 1: Obter todos os usuários

PS C:\> Get-MsolUser

Esse comando recupera todos os usuários da empresa. Ele exibe até o valor padrão de 500 resultados.

Exemplo 2: Obter usuários habilitados

PS C:\> Get-MsolUser -EnabledFilter EnabledOnly -MaxResults 2000

Esse comando obtém até 2.000 usuários habilitados.

Exemplo 3: Obter um usuário por UPN

PS C:\> Get-MsolUser -UserPrincipalName "davidchew@contoso.com"

Esse comando recupera o usuário com o UPN davidchew@contoso.com.

Exemplo 4: Obter um usuário por ID de objeto

PS C:\> Get-MsolUser -ObjectId 81701046-cb37-439b-90ce-2afd9630af7d

Esse comando recupera um usuário que tem a ID de objeto especificada.

Exemplo 5: Obter usuários por cadeia de caracteres de pesquisa

PS C:\> Get-MsolUser -SearchString "David"

Esse comando recupera uma lista de usuários com David no nome de exibição ou endereço de email.

Exemplo 6: Obter o local de dados preferencial de um usuário

PS C:\> Get-MsolUser -UserPrincipalName "davidchew@contoso.onmicrosoft.com" | Select PreferredDataLocation

Esse comando retorna o local de dados preferencial de um usuário.

Parâmetros

-All

Indica que este cmdlet retorna todos os resultados. Não especifique junto com o parâmetro MaxResults .

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

-City

Especifica a cidade na qual filtrar os resultados.

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

-Country

Especifica o país ou a região no qual filtrar os resultados.

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

-Department

Especifica o departamento no qual filtrar os resultados.

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

-DomainName

Especifica o domínio no qual filtrar os resultados. Esse deve ser um domínio verificado para a empresa. Todos os usuários com um endereço de email, primário ou secundário, nesse domínio são retornados.

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

-EnabledFilter

Especifica o filtro para usuários habilitados ou desabilitados. Os valores válidos são All, EnabledOnly e DisabledOnly.

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

-HasErrorsOnly

Inida que esse cmdlet retorna apenas usuários que têm erros de validação.

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

-LicenseReconciliationNeededOnly

Indica que esse filtro de cmdlet só é usado para usuários que exigem reconciliação de licença.

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

-MaxResults

Especifica o número máximo de resultados que esse cmdlet retorna. O valor padrão é 500.

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

-ObjectId

Especifica a ID de objeto exclusiva do usuário a ser obtido.

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

-ReturnDeletedUsers

Indica que esse cmdlet retorna apenas usuários na lixeira.

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

-SearchString

Especifica uma cadeia de caracteres para corresponder ao endereço de email ou ao nome de exibição começando com essa cadeia de caracteres.

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

-State

Especifica o filtro para o estado do usuário.

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

-Synchronized

Indica que esse cmdlet retorna apenas usuários sincronizados por meio da Sincronização do Azure Active Directory.

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

-TenantId

Especifica a ID exclusiva do locatário no qual executar a operação. O valor padrão é o locatário do usuário atual. Esse parâmetro se aplica somente a usuários parceiros.

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

-Title

Speicifis o filtro para o título do usuário.

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

-UnlicensedUsersOnly

Indica que esse cmdlet retorna apenas usuários que não recebem uma licença.

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

-UsageLocation

Especifica o filtro para o país ou região em que os serviços são consumidos pelo usuário. Especifique um código de país ou região de duas letras.

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

-UserPrincipalName

Speicifis a ID de usuário do usuário a recuperar.

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

Saídas

Microsoft.Online.Administration.User

Esse cmdlet retorna objetos de usuário, que incluem as seguintes informações:

  • AlternateEmailAddresses. Endereço de email alternativo do usuário (externo ao Azure Active Directory).

  • BlockCredential. se o usuário é ou não capaz de fazer logon.

  • Cidade. a cidade do usuário.

  • País. O país ou a região do usuário.

  • Departamento. o departamento do usuário.

  • DisplayName. O nome de exibição do usuário.

  • Erros. uma matriz de erros. Esses são erros de validação que podem resultar em perda de serviços.

  • Fax. o número de fax do usuário.

  • Firstname. O nome do usuário.

  • ImmutableID. somente retornado para os usuários federados. Essa é a ID necessária para ser federada com o Azure Active Directory.

  • isBlackBerryUser. retorna se o usuário tem ou não um dispositivo BlackBerry.

  • isLicensed. se o usuário tem ou não alguma licença atribuída.

  • LastDirSyncTime. A data e a hora da última sincronização de diretório (retornada somente de usuários sincronizados com o Azure Active Directory por meio da sincronização do Active Directory).

  • LastPasswordChangeTimestamp. A hora mais recente em que uma alteração de senha para o usuário foi registrada no Azure Active Directory.

  • LastName. O sobrenome do usuário.

  • LicenseReconciliationNeeded. se o usuário atualmente tem ou não uma caixa de correio sem uma licença. Neste caso, o usuário deve estar licenciado durante 30 dias para evitar perder sua caixa de correio.

  • Licenças. uma lista de licenças do usuário.

  • Liveid. o ID de logon exclusivo do usuário.

  • Celular. o número de celular do usuário.

  • Objectid. o ID exclusivo do usuário.

  • Escritório. o número do escritório do usuário.

  • OverallProvisioningStatus. se o usuário foi ou não provisionado para seus serviços.

  • PasswordNeverExpires. se a senha do usuário deve ou não ser forçada a ser alterada a cada 90 dias.

  • Phonenumber. o número de telefone do usuário.

  • Postalcode. o CEP do usuário.

  • PreferredDataLocation. O local de dados preferencial do usuário.

  • PreferredLanguage. o idioma preferido do usuário.

  • Proxyaddresses. Os endereços proxy associados a esse usuário.

  • Estado. o estado do usuário.

  • Streetaddress. o endereço do usuário.

  • StrongPasswordRequired. se o usuário deve ou não definir uma senha forte quando altera sua senha. As senhas fortes são recomendadas.

  • Título. o título do usuário.

  • UsageLocation. O país ou região em que os serviços são consumidos pelo usuário. Deve ser um código de país ou região de duas letras.

  • Userprincipalname. o ID do usuário.

  • ValidationStatus. se o usuário tem ou não algum erro.