Partilhar via

Get-MsolContact

  • Referência
Módulo:
MSOnline

Obtém contactos do Azure Active Directory.

Sintaxe

Get-MsolContact
   [-HasErrorsOnly <Boolean>]
   [-SearchString <String>]
   [-MaxResults <Int32>]
   [-TenantId <Guid>]
   [<CommonParameters>]
Get-MsolContact
   -ObjectId <Guid>
   [-TenantId <Guid>]
   [<CommonParameters>]
Get-MsolContact
   [-HasErrorsOnly <Boolean>]
   [-SearchString <String>]
   [-All]
   [-TenantId <Guid>]
   [<CommonParameters>]

Description

O cmdlet Get-MsolContact obtém um objeto de contacto ou uma lista de contactos. Especifique o parâmetro ObjectId para obter um único contacto.

Exemplos

Exemplo 1: Obter um contacto

PS C:\> Get-MsolContact -ObjectId adc41dc7-4130-4215-adfb-2403bc9f844e

Este comando obtém um contacto.

Exemplo 2: obter contactos que correspondam a uma cadeia

PS C:\> Get-MsolContact -SearchString "Patti"

Este comando obtém uma lista de contactos com um nome a apresentar ou endereço de e-mail a partir da Patti.

Parâmetros

-All

Indica que este cmdlet devolve todos os resultados que encontrar. Não especifique este parâmetro e o parâmetro MaxResults .

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

-HasErrorsOnly

Indica que este cmdlet devolve contactos com erros de validação.

Tipo:Boolean
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 contacto a obter.

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

-SearchString

Especifica uma cadeia. Este cmdlet devolve contactos com um nome a apresentar ou endereço de e-mail que começam com esta cadeia.

Tipo:String
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

Saídas

Microsoft.Online.Administration.Contact

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

  • A cidade. A cidade do contacto.

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

  • Departamento. O departamento de contactos.

  • DisplayName. O nome a apresentar do contacto.

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

  • FirstName. O nome próprio do contacto.

  • LastDirSyncTime. Devolve a data e hora da última sincronização (apenas devolvida dos contactos sincronizados com a sincronização do Active Directory).

  • LastName. O apelido do contacto.

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

  • ObjectId. O ID exclusivo do contacto.

  • O Office. O número do escritório do contacto.

  • Número de Telefone. O número de telefone do contacto.

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

  • Endereços Proxy. Os endereços proxy associados a este contacto.

  • Estado. O estado do contacto.

  • StreetAddress. A morada do contacto.

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

  • UserPrincipalName. O ID de utilizador do contacto.

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