Get-MailContact

  • Artigo

 

Aplica-se a: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

Tópico modificado em: 2010-04-27

Use o cmdlet Get-MailContact para recuperar todos os atributos do contato especificado do Active Directory.

Sintaxe

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

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

Get-MailContact [-Anr <String>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-IgnoreDefaultScope <SwitchParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-RecipientTypeDetails <RecipientTypeDetails[]>] [-ResultSize <Unlimited>] [-SortBy <String>]

Descrição detalhada

Este cmdlet 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 para a organização do Exchange será retornada.

Para executar o cmdlet Get-MailContact, você deve usar a conta à qual esteja delegada a seguinte função:

  • Função Administrador Somente para Exibição do Exchange

Para obter mais informações sobre permissões, delegação de funções e os direitos necessários para administrar o Microsoft Exchange Server 2007, consulte Considerações sobre permissão.

Parâmetros

Parâmetro Necessário Tipo Descrição

ANR

Opcional

System.String

O parâmetro especificado é determinado usando ANR (resolução de nomes ambíguos). Os atributos padrão pesquisados são:

  • CommonName (CN)

  • DisplayName (displayName)

  • FirstName (givenName)

  • LastName (sn)

  • Alias (mailNickname)

  • LegacyExchangeDN (legacyExchangeDN)

  • Name (name) (em vez de CommonName/CN)

  • EmailAddresses (proxyAddresses)

  • SamAccountName (samAccountName)

  • Office (physicalDeliveryOfficeName)

Credential

Opcional

System.Management.Automation.PSCredential

Este parâmetro especifica a conta a ser usada para obter acesso ao Active Directory.

Se o parâmetro Credential for usado, o comando solicitará a senha da conta antes de continuar.

DomainController

Opcional

Microsoft.Exchange.Data.Fqdn

Para especificar o nome de domínio totalmente qualificado do controlador de domínio que recupera dados do Active Directory, inclua o parâmetro DomainController no comando.

Filter

Opcional

System.String

Este parâmetro é usado para filtrar a lista de destinatários retornados. Você pode especificar os atributos para filtrar.

Para obter mais informações sobre as propriedades filtráveis, consulte Propriedades filtráveis do parâmetro -Filter.

Identity

Opcional

Microsoft.Exchange.Configuration.Tasks.MailContactIdParameter

Esse parâmetro identifica o contato. Você pode incluir o ADObjectID do contato, o nome distinto, o LegacyExchangeDN, a GUID, o Domain\SamAccountName, o nome UPN, o endereço de email ou o alias.

OrganizationalUnit

Opcional

Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter

Este parâmetro especifica um contêiner no qual limitar os resultados. Uma OU (unidade organizacional) ou um domínio pode ser especificado. Além disso, o nome canônico deve ser especificado. Por exemplo:

  • UO: westcoast.contoso.com/users

  • Domínio: westcoast.contoso.com

ReadFromDomainController

Opcional

System.Management.Automation.SwitchParameter

Esse parâmetro especifica se as informações do usuário são lidas a partir de um controlador de domínio no domínio do usuário. Se você definir o escopo do destinatário para incluir todos os destinatários da floresta e não usar esse parâmetro, talvez as informações do usuário sejam lidas a partir de um catálogo global com informações desatualizadas. Se você usar esse parâmetro, várias leituras poderão ser necessárias para obter as informações.

Dica

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

RecipientTypeDetails

Opcional

Microsoft.Exchange.Data.Directory.Recipient.RecipientTypeDetails[]

O parâmetro RecipientTypeDetails especifica o tipo de destinatários que são retornados. Os tipos de destinatários no Exchange 2007 são divididos em tipos e subtipos de destinatários. Cada tipo de destinatário contém todas as propriedades comuns para todos os subtipos. Por exemplo, o tipo UserMailbox representa uma conta de usuário no Active Directory com uma caixa de correio associada. Como há vários tipos de caixas de correio, cada tipo é identificado pelo parâmetro RecipientTypeDetails. Por exemplo, uma caixa de correio de sala de conferência tem RecipientTypeDetails definido como ConferenceRoomMailbox, enquanto uma caixa de correio de usuário tem RecipientTypeDetails definido como UserMailbox.

Para esse cmdlet, os detalhes de tipo de destinatário disponíveis são:

  • MailEnabledContact

  • MailEnabledForestContact

ResultSize

Opcional

Microsoft.Exchange.Data.Unlimited

Esse parâmetro especifica o número total de objetos de destinatário a serem retornados. Se não for especificado, o parâmetro retornará todos os resultados que correspondem ao filtro.

SortBy

Opcional

System.String

Este parâmetro especifica o atributo pelo qual classificar os resultados. A classificação é realizada em um atributo de cada vez e é sempre executada na ordem crescente.

IgnoreDefaultScope

Opcional

System.Management.Automation.SwitchParameter

O parâmetro IgnoreDefaultScope instrui o comando a ignorar a configuração padrão de escopo do destinatário do Shell de Gerenciamento do Exchange e usar toda a floresta como o escopo. Isso permite que o comando acesse objetos do Active Directory que não estão atualmente no escopo padrão. O uso do parâmetro IgnoreDefaultScope introduz as seguintes restrições:

  • Você não pode usar o parâmetro DomainController. O comando usará automaticamente um servidor de catálogo global adequado.

  • Só é possível usar o DN para o parâmetro Identity. Outras formas de identificação, como alias ou GUID, não são aceitas.

  • Você não pode usar os parâmetros OrganizationalUnit e Identity juntos.

  • Você não pode usar o parâmetro Credential.

Tipos de entrada

Tipos de retorno

Erros

Erro Descrição

Exceções

Exceções Descrição

Exemplo

Neste exemplo, o comando Get-MailContact é usado para recuperar o contato habilitado para email, chamado Ted.

Get-MailContact -Identity Ted | Format-List