Get-AddressList

Artigo
09/30/2014

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

Tópico modificado em: 2007-06-28

Use o cmdlet Get-AddressList para exibir todos os atributos de uma lista de endereços.

Sintaxe

Get-AddressList [-Identity <AddressListIdParameter>] [-DomainController <Fqdn>]

Get-AddressList -Container <AddressListIdParameter> [-DomainController <Fqdn>]

Descrição detalhada

Para executar o cmdlet Get-AddressList, 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 Exchange Server 2007, consulte Considerações sobre permissão.

Parâmetros

Parâmetro	Necessário	Tipo	Descrição
Container	Necessário	Microsoft.Exchange.Configuration.Tasks.AddressListIdParameter	Esse parâmetro especifica a identidade da lista de endereços pai da lista ou das listas de endereços que você deseja exibir. Se nenhuma lista de endereços pai for especificada, o comando obterá todas as listas de endereços sob a raiz "Todas as Listas de Endereços".
Identity	Opcional	Microsoft.Exchange.Configuration.Tasks.AddressListIdParameter	Utilize o parâmetro Identity para especificar a GUID, o nome distinto ou o nome da lista de endereços que representa uma lista específica de endereços. Você também pode incluir o caminho utilizando o formato Path\AddressListName. Você pode omitir o rótulo do parâmetro Identity para que somente o nome da lista de endereços ou a GUID seja fornecido.
DomainController	Opcional	Microsoft.Exchange.Data.Fqdn	Para especificar o nome de domínio totalmente qualificado (FQDN) do controlador de domínio que recupera dados do serviço de diretório do Active Directory, inclua o parâmetro DomainController no comando.

Container

Necessário

Microsoft.Exchange.Configuration.Tasks.AddressListIdParameter

Esse parâmetro especifica a identidade da lista de endereços pai da lista ou das listas de endereços que você deseja exibir. Se nenhuma lista de endereços pai for especificada, o comando obterá todas as listas de endereços sob a raiz "Todas as Listas de Endereços".

Identity

Opcional

Microsoft.Exchange.Configuration.Tasks.AddressListIdParameter

Utilize o parâmetro Identity para especificar a GUID, o nome distinto ou o nome da lista de endereços que representa uma lista específica de endereços. Você também pode incluir o caminho utilizando o formato Path\AddressListName.

Você pode omitir o rótulo do parâmetro Identity para que somente o nome da lista de endereços ou a GUID seja fornecido.

DomainController

Opcional

Microsoft.Exchange.Data.Fqdn

Para especificar o nome de domínio totalmente qualificado (FQDN) do controlador de domínio que recupera dados do serviço de diretório do Active Directory, inclua o parâmetro DomainController no comando.

Tipos de entrada

Tipos de retorno

Erros

Erro	Descrição

Exceções

Exceções	Descrição

Exemplo

O primeiro exemplo mostra como obter os atributos de todas as listas de endereços no contêiner "Todas as Listas de Endereços".

O segundo exemplo mostra como obter os atributos da lista de endereços denominada building4 e localizada na lista de endereços "All Users\Sales\", usando o controlador de domínio DomainController01.

Get-AddressList 
Get-AddressList -Identity "All Users\Sales\building4" -DomainController DomainController01

Você pode canalizar a saída do cmdlet Get-AddressList para os cmdlets Remove-AddressList, Set-AddressList, Update-Addresslist e Move-AddressList, em vez de usar o parâmetro Identity com cada um desses cmdlets.

Compartilhar via