Get-MailContact

Este cmdlet está disponível no Exchange local e no serviço baseado na nuvem. Alguns parâmetros e configurações podem ser exclusivos de um ou outro ambiente.

Use o cmdlet Get-MailContact para criar contatos de email existentes.

Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax.

Syntax

Get-MailContact
   [-ANR <String>]
   [-Credential <PSCredential>]
   [-DomainController <Fqdn>]
   [-Filter <String>]
   [-IgnoreDefaultScope]
   [-OrganizationalUnit <OrganizationalUnitIdParameter>]
   [-ReadFromDomainController]
   [-RecipientTypeDetails <RecipientTypeDetails[]>]
   [-ResultSize <Unlimited>]
   [-SortBy <String>]
   [<CommonParameters>]
Get-MailContact
   [[-Identity] <MailContactIdParameter>]
   [-Credential <PSCredential>]
   [-DomainController <Fqdn>]
   [-Filter <String>]
   [-IgnoreDefaultScope]
   [-OrganizationalUnit <OrganizationalUnitIdParameter>]
   [-ReadFromDomainController]
   [-RecipientTypeDetails <RecipientTypeDetails[]>]
   [-ResultSize <Unlimited>]
   [-SortBy <String>]
   [<CommonParameters>]

Description

O cmdlet Get-MailContact recupera todos os atributos do contato especificado. Nenhum parâmetro é necessário. Se o cmdlet for executado sem um parâmetro, uma lista completa de contatos da organização do Exchange será retornada.

Para executar esse cmdlet, você precisa ter permissões. Embora este tópico liste todos os parâmetros do cmdlet, talvez você não tenha acesso a alguns parâmetros se eles não estiverem incluídos nas permissões atribuídas a você. Para localizar as permissões necessárias para executar qualquer cmdlet ou parâmetro em sua organização, confira Find the permissions required to run any Exchange cmdlet.

Examples

Exemplo 1

Get-MailContact

Esse exemplo retorna uma lista resumida de todos os contatos de email.

Exemplo 2

Get-MailContact -Identity Arlene | Format-List

Esse exemplo recupera informações detalhadas da usuária de email chamada Valentina.

Parameters

-ANR

O parâmetro Anr especifica uma cadeia de caracteres na qual executar uma pesquisa ANR (resolução de nomes ambíguos). Você pode especificar uma cadeia de caracteres parcial para objetos com um atributo correspondente a esta cadeia de caracteres. Os atributos padrão pesquisados são:

  • CommonName (CN)

  • DisplayName

  • FirstName

  • LastName

  • Alias

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection
-Credential

Este parâmetro está disponível somente no Exchange local.

O parâmetro Credential especifica o nome de usuário e a senha usados para executar este comando. Normalmente, você usa esse parâmetro em scripts ou quando você precisa fornecer credenciais diferentes que têm as permissões necessárias.

Um valor para esse parâmetro requer o cmdlet Get-Credential. Para pausar o comando e receber uma solicitação de credenciais, use o valor (Get-Credential). Ou, antes de executar esse comando, armazene as credenciais em uma variável (por exemplo, $cred = Get-Credential) e, em seguida, use o nome da variável ($cred) para esse parâmetro. Para saber mais, confira Obter credencial.

Type:PSCredential
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
-DomainController

Este parâmetro está disponível somente no Exchange local.

O parâmetro DomainController especifica o controlador de domínio que é usado por esse cmdlet para ler dados ou gravar dados no Active Directory. Você identifica o controlador de domínio por seu FQDN (nome de domínio totalmente qualificado). Por exemplo, dc01.contoso.com.

Type:Fqdn
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
-Filter

O parâmetro Filter usa a sintaxe OPath para filtrar os resultados de acordo com as propriedades e os valores especificados. Os critérios de pesquisa usam a sintaxe "Property -ComparisonOperator 'Value'" .

  • Coloque todo o filtro OPath entre aspas duplas "". Se o filtro contiver valores de sistema (por exemplo,, $true $false ou $null ), use aspas simples. Embora esse parâmetro seja uma cadeia de caracteres (não um bloco de sistema), você também pode usar chaves {}, mas somente se o filtro não contiver variáveis.

  • Propriedade é uma propriedade filtrável. Para obter mais informações sobre as propriedades filtráveis, consulte Filterable Properties for the filter Parameter.

  • ComparisonOperator é um operador de comparação de OPath (por exemplo -eq , igual a e -like para comparação de cadeia de caracteres). Para obter mais informações sobre operadores de comparação, consulte about_Comparison_Operators.

  • Value é o valor da propriedade a ser pesquisada. Coloque valores de texto e variáveis entre aspas simples ( 'Value' ou '$Variable' ). Se um valor de variável contiver aspas simples, você precisará identificar (escapar) as aspas simples para expandir a variável corretamente. Por exemplo, em vez de '$User' , use '$($User -Replace "'","''")' . Não coloque números inteiros ou valores do sistema (por exemplo,,, 500 $true $false ou $null ).

Você pode encadear vários critérios de pesquisa juntos usando os operadores lógicos -and e -or . Por exemplo, "Criteria1 -and Criteria2" ou "(Criteria1 -and Criteria2) -or Criteria3" .

Para obter informações detalhadas sobre filtros do OPath no Exchange, consulte Additional OPATH Syntax Information.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection
-Identity

O parâmetro Identity especifica o contato de email que você deseja visualizar. É possível usar qualquer valor que identifique o contato de email com exclusividade. Por exemplo:

  • Nome

  • Alias

  • Nome diferenciado (DN)

  • Nome diferenciado (DN)

  • DN canônico

  • GUID

Type:MailContactIdParameter
Position:1
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection
-IgnoreDefaultScope

Este parâmetro está disponível somente no Exchange local.

O parâmetro IgnoreDefaultScope instrui o comando a ignorar a configuração de escopo do destinatário padrão do Shell de Gerenciamento do Exchange e usar toda a floresta como escopo. Isso permite ao comando acessar os objetos do Active Directory que não estão atualmente disponíveis no escopo padrão.

O uso do parâmetro IgnoreDefaultScope apresenta as seguintes restrições:

  • Não é possível usar o parâmetro DomainController. O comando usa um servidor de catálogo global adequado automaticamente.

  • Não é possível usar o parâmetro DomainController. O comando usa um servidor de catálogo global adequado automaticamente.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
-OrganizationalUnit

O parâmetro OrganizationalUnit filtra os resultados com base no local do objeto no Active Directory. Somente objetos que existem na localização especificada são retornados. A entrada válida para esse parâmetro é uma UO (unidade organizacional) ou um domínio retornado pelo cmdlet Get-OrganizationalUnit. É possível usar qualquer valor que identifique a UO ou o domínio com exclusividade. Por exemplo:

  • Nome

  • Nome

  • Nome diferenciado (DN)

  • GUID

Type:OrganizationalUnitIdParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection
-ReadFromDomainController

Este parâmetro está disponível somente no Exchange local.

A opção ReadFromDomainController especifica se as informações devem ser lidas de um controlador de domínio no domínio do usuário. Se você executar o comando Set-AdServerSettings -ViewEntireForest $true para incluir todos os objetos da floresta e não usar a opção ReadFromDomainController, será possível que as informações do usuário sejam lidas de um catálogo global com informações desatualizadas. Se você usar a opção ReadFromDomainController, várias leituras poderão ser necessárias para obter as informações. Você não precisa especificar um valor com essa opção.

Por padrão, o escopo do destinatário é definido como o domínio que hospeda seus servidores do Exchange.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
-RecipientTypeDetails

O parâmetro RecipientTypeDetails filtra os resultados pelo subtipo de contato de email especificado. Os valores válidos são:

  • MailContact

  • MailForestContact

SPO: exSharePointOnline2ndMen

Type:RecipientTypeDetails[]
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection
-Resultados

O parâmetro ResultSize especifica o número máximo de resultados a serem retornados. Caso pretenda retornar todas as solicitações correspondentes à consulta, use unlimited como valor desse parâmetro. O valor padrão é 1000.

Type:Unlimited
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection
-SortBy

O parâmetro SortBy especifica a propriedade pela qual classificar os resultados. Você pode classificar apenas por uma propriedade de cada vez. Os resultados são classificados em ordem crescente.

Se o modo de exibição padrão não incluir a propriedade que você está classificando, você pode anexar o comando com | Format-Table-auto <Property1> , <Property2> ... para criar um novo modo de exibição que contenha todas as propriedades que você deseja ver. Há suporte para caracteres curinga ( * ) nos nomes das propriedades.

É possível classificar pelas seguintes propriedades:

  • Nome

  • DisplayName

  • Alias

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

Inputs

Para ver os tipos de entrada que este cmdlet aceita, confira Tipos de entrada e saída de cmdlet. Se o campo Tipo de Entrada de um cmdlet estiver em branco, isso significa que o cmdlet não aceita dados de entrada.

Outputs

Para ver os tipos de retorno, também conhecidos como tipos de saída, que este cmdlet aceita, consulte Tipos de entrada e saída de cmdlet. Se o campo Tipo de Saída estiver em branco, o cmdlet não retorna dados.