Compartilhar via

Get-MsolContact

  • Referência
Módulo:
MSOnline

Obtém contatos 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 contato ou uma lista de contatos. Especifique o parâmetro ObjectId para obter um único contato.

Exemplos

Exemplo 1: Obter um contato

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

Esse comando recupera um contato.

Exemplo 2: Obter contatos que correspondam a uma cadeia de caracteres

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

Esse comando recupera uma lista de contatos com um nome de exibição ou endereço de email começando com Patti.

Parâmetros

-All

Indica que esse cmdlet retorna todos os resultados encontrados. Não especifique esse parâmetro e 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

-HasErrorsOnly

Indica que este cmdlet retorna contatos que têm erros de validação.

Tipo:Boolean
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 retornados por este cmdlet. 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 contato a ser obtido.

Tipo:Guid
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. Esse cmdlet retorna contatos com um nome de exibição ou endereço de email que começam 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

-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

Saídas

Microsoft.Online.Administration.Contact

Esse cmdlet retorna objetos de contato, que incluem as seguintes informações:

  • Cidade. A cidade do contato.

  • País. O país ou região do contato.

  • Departamento. O departamento do contato.

  • DisplayName. O nome de exibição do contato.

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

  • Firstname. O nome do contato.

  • LastDirSyncTime. Retorna a data e hora da última sincronização (somente retornada de contatos sincronizados com a sincronização do Active Directory).

  • LastName. O sobrenome do contato.

  • Celular. O número do celular do contato.

  • Objectid. A ID exclusiva da contato.

  • Escritório. O número comercial do contato.

  • Número de telefone. O número de telefone do contato.

  • Cep. O CEP do contato.

  • Endereços proxy. Os endereços proxy associados a esse contato.

  • Estado. O estado do contato.

  • Streetaddress. O endereço do contato.

  • Título. A posição do contato.

  • Userprincipalname. A ID do usuário do contato.

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