Partilhar via

Get-MsolUser

  • Referência
Módulo:
MSOnline

Obtém utilizadores 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 utilizador individual ou uma lista de utilizadores. Especifique o parâmetro ObjectId ou UserPrincipalName para obter um utilizador específico.

Exemplos

Exemplo 1: Obter todos os utilizadores

PS C:\> Get-MsolUser

Este comando obtém todos os utilizadores na empresa. Apresenta até ao valor predefinido de 500 resultados.

Exemplo 2: Obter utilizadores ativados

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

Este comando recebe até 2000 utilizadores ativados.

Exemplo 3: Obter um utilizador por UPN

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

Este comando obtém o utilizador com o UPN davidchew@contoso.com.

Exemplo 4: Obter um utilizador por ID de objeto

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

Este comando obtém um utilizador que tem o ID de objeto especificado.

Exemplo 5: Obter utilizadores por cadeia de pesquisa

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

Este comando obtém uma lista de utilizadores com o David no nome a apresentar ou endereço de e-mail.

Exemplo 6: obter a localização de dados preferencial de um utilizador

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

Este comando devolve a localização de dados preferencial de um utilizador.

Parâmetros

-All

Indica que este cmdlet devolve todos os resultados. Não especifique em conjunto com o parâmetro MaxResults .

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-City

Especifica a cidade para filtrar os resultados.

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Country

Especifica o país ou região para filtrar os resultados.

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Department

Especifica o departamento para filtrar os resultados.

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-DomainName

Especifica o domínio para filtrar os resultados. Este tem de ser um domínio verificado para a empresa. Todos os utilizadores com um endereço de e-mail, primário ou secundário, neste domínio são devolvidos.

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-EnabledFilter

Especifica o filtro para utilizadores ativados ou desativados. Os valores válidos são All, EnabledOnly e DisabledOnly.

Tipo:UserEnabledFilter
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-HasErrorsOnly

Inidata que este cmdlet devolve apenas utilizadores com erros de validação.

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-LicenseReconciliationNeededOnly

Indica que este filtro de cmdlet apenas para utilizadores que necessitam de reconciliação de licenças.

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-MaxResults

Especifica o número máximo de resultados que este cmdlet devolve. O valor predefinido é 500.

Tipo:Int32
Position:Named
Default value:500
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-ObjectId

Especifica o ID de objeto exclusivo do utilizador a obter.

Tipo:Guid
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-ReturnDeletedUsers

Indica que este cmdlet devolve apenas os utilizadores na reciclagem.

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-SearchString

Especifica uma cadeia para corresponder ao endereço de e-mail ou nome a apresentar a partir desta cadeia.

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-State

Especifica o filtro para o estado do utilizador.

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Synchronized

Indica que este cmdlet devolve apenas os utilizadores sincronizados através do Azure Active Directory Sync.

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-TenantId

Especifica o ID exclusivo do inquilino no qual efetuar a operação. O valor predefinido é o inquilino do utilizador atual. Este parâmetro aplica-se apenas aos utilizadores parceiros.

Tipo:Guid
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-Title

Speicifis o filtro para o título do utilizador.

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-UnlicensedUsersOnly

Indica que este cmdlet devolve apenas os utilizadores a quem não foi atribuída uma licença.

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-UsageLocation

Especifica o filtro para o país ou região onde os serviços são consumidos pelo utilizador. Especifique um código de país ou região de duas letras.

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-UserPrincipalName

O Speicifis o ID de utilizador do utilizador a obter.

Tipo:String
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

Saídas

Microsoft.Online.Administration.User

Este cmdlet devolve objetos de utilizador, que incluem as seguintes informações:

  • AlternateEmailAddresses. Endereço de e-mail alternativo do utilizador (externo ao Azure Active Directory).

  • BlockCredential. Se o utilizador consegue ou não iniciar sessão.

  • A cidade. A cidade do utilizador.

  • O país. O país ou região do utilizador.

  • Departamento. O departamento do utilizador.

  • DisplayName. O nome a apresentar do utilizador.

  • Erros. Uma matriz de erros. Estes são erros de validação que podem resultar na perda de serviços.

  • Fax. O número de fax do utilizador.

  • NomePróprio. O nome próprio do utilizador.

  • ImutávelID. Apenas devolvido para utilizadores federados. Este é o ID necessário para ser federado com o Azure Active Directory.

  • isBlackBerryUser. Devolve se o utilizador tem ou não um dispositivo BlackBerry.

  • isLicensed. Se o utilizador tem ou não licenças atribuídas.

  • LastDirSyncTime. A data e hora da última sincronização de diretórios (apenas devolvida pelos utilizadores sincronizados com o Azure Active Directory através da sincronização do Active Directory).

  • LastPasswordChangeTimestamp. A hora mais recente em que uma alteração de palavra-passe para o utilizador foi registada no Azure Active Directory.

  • Apelido. O apelido do utilizador.

  • LicenseReconciliationNeeded. Se o utilizador tem ou não uma caixa de correio sem uma licença. Neste caso, o utilizador deve ter uma licença de 30 dias para evitar perder a caixa de correio.

  • Licenças. Uma lista das licenças do utilizador.

  • LiveID. O ID de início de sessão exclusivo do utilizador.

  • MobilePhone. O número de telemóvel do utilizador.

  • ObjectId. O ID exclusivo do utilizador.

  • O Office. O número de escritório do utilizador.

  • OverallProvisioningStatus. Se o utilizador foi ou não aprovisionado para os seus serviços.

  • PasswordNeverExpires. Se a palavra-passe do utilizador deve ser forçada a ser alterada a cada 90 dias.

  • PhoneNumber. O número de telefone do utilizador.

  • Código Postal. O código postal do utilizador.

  • PreferredDataLocation. A localização de dados preferencial do utilizador.

  • PreferredLanguage. O idioma preferencial do utilizador.

  • ProxyAddresses. Os endereços proxy associados a este utilizador.

  • Estado. O estado do utilizador.

  • StreetAddress. A morada do utilizador.

  • StrongPasswordRequired. Se o utilizador é obrigado a definir uma palavra-passe segura quando altera a palavra-passe. São recomendadas palavras-passe fortes.

  • Título. O título do utilizador.

  • UsageLocation. O país ou região onde os serviços são consumidos pelo utilizador. Tem de ser um indicativo de país ou região de duas letras.

  • UserPrincipalName. O ID de utilizador do utilizador.

  • ValidationStatus. Se o utilizador tem ou não erros.