Get-AddressList
Este cmdlet está disponível no Exchange local e no serviço baseado na nuvem. Alguns parâmetros e definições podem ser exclusivos de um ambiente ou outro.
Use o cmdlet Get-AddressList para visualizar listas de endereços.
No Exchange Online, este cmdlet só está disponível na função Listas de Endereços e, por predefinição, a função não é atribuída a nenhum grupo de funções. Para utilizar este cmdlet, tem de adicionar a função Listas de Endereços a um grupo de funções (por exemplo, ao grupo de funções Gestão de Organizações). Para obter mais informações, veja Adicionar uma função a um grupo de funções.
Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax.
Sintaxe
Container
Get-AddressList
-Container <AddressListIdParameter>
[-DomainController <Fqdn>]
[<CommonParameters>]
Identity
Get-AddressList
[[-Identity] <AddressListIdParameter>]
[-DomainController <Fqdn>]
[<CommonParameters>]
SearchSet
Get-AddressList
[-SearchText <String>]
[-DomainController <Fqdn>]
[<CommonParameters>]
Description
Pode encaminhar a saída do cmdlet Get-AddressList para os cmdlets Remove-AddressList, Set-AddressList, Update-AddressList e Move-AddressList em vez de utilizar o parâmetro Identity com cada um desses cmdlets.
Para executar esse cmdlet, você precisa ter permissões. Embora este artigo liste todos os parâmetros do cmdlet, poderá não ter acesso a alguns parâmetros se não estiverem incluídos nas permissões que lhe foram atribuídas. 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.
Exemplos
Exemplo 1
Get-AddressList
Esse exemplo retorna uma lista resumida de todas as listas de endereços.
Exemplo 2
Get-AddressList -Identity "All Users\Sales\building4" | Format-List
Este exemplo retorna informações detalhadas da lista de endereços building4 localizada em Todos os Usuários\Vendas\.
Parâmetros
-Container
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
O parâmetro Container filtra os resultados com base no local da lista de endereços. Apenas listas de endereços no caminho especificado são retornadas. Entrada válida para esse parâmetro é a raiz "\" (também conhecido como todas as listas de endereços) ou uma lista de endereços existente. É possível usar qualquer valor que identifique a lista de endereços com exclusividade. Por exemplo:
- Nome
- DN (nome diferenciado)
- GUID
- Caminho:
"\AddressListName"ou"\ContainerName\AddressListName"(por exemplo,"\All Users"ou"\All Contacts\Marketing")
Não é possível usar este parâmetro com os parâmetros Identity ou SearchText.
Propriedades do parâmetro
| Tipo: | AddressListIdParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
Container
| Cargo: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-DomainController
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
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.
Propriedades do parâmetro
| Tipo: | Fqdn |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Identity
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
O parâmetro Identity especifica a lista de endereços que você deseja visualizar. É possível usar qualquer valor que identifique a lista de endereços com exclusividade. Por exemplo:
- Nome
- DN (nome diferenciado)
- GUID
- Caminho:
"\AddressListName"ou"\ContainerName\AddressListName"(por exemplo,"\All Users"ou"\All Contacts\Marketing")
Não é possível usar este parâmetro com os parâmetros Container ou SearchText.
Atenção: o valor $null ou um valor inexistente para o parâmetro Identidade devolve todos os objetos como se tivesse executado o comando Get- sem o parâmetro Identity. Verifique se as listas de valores do parâmetro Identity estão corretas e não contêm valores de $null inexistentes.
Propriedades do parâmetro
| Tipo: | AddressListIdParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
Identity
| Cargo: | 1 |
| Obrigatório: | False |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
-SearchText
Aplicável: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
O parâmetro SearchText filtra os resultados com base no nome e no nome de exibição da lista de endereços. Somente listas de endereços cujos nomes ou nomes de exibição que contenham uma cadeia de caracteres de texto especificada são retornados. Se o valor contiver espaços, coloque-o entre aspas (").
Não é possível usar este parâmetro com os parâmetros Container ou Identity.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
SearchSet
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
CommonParameters
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, confira about_CommonParameters.
Entradas
Input types
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.
Saídas
Output types
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.