Share via

Get-MsolContact

  • Referência
Módulo:
MSOnline

Obtém contatos do Azure Active Directory.

Syntax

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 .

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-HasErrorsOnly

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

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MaxResults

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

Type:Int32
Position:Named
Default value:500
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ObjectId

Especifica a ID de objeto exclusiva do contato a ser obtido.

Type:Guid
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:Guid
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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.