Gerenciar listas de endereços no Exchange Online
Uma lista de endereços é uma coleção de objetos de destinatários habilitados por email no Exchange Online. As listas de endereços são baseadas em filtros de destinatário. Para obter mais informações sobre listas de endereços, consulte Listas de endereços no Exchange Online.
Para tarefas de gerenciamento adicionais relacionadas a gerenciar listas de endereços, consulte Procedimentos no Exchange Online da lista de endereços.
Procurando a versão do Exchange Server deste tópico? Consulte Create listas de endereços.
Do que você precisa saber para começar?
Tempo estimado para concluir cada procedimento: 5 minutos.
Por padrão, a função Lista de Endereços não é atribuída a nenhum grupo de funções no Exchange Online. Para usar quaisquer cmdlets que exijam a função de Lista de Endereços, é necessário adicionar essa função a um grupo de funções. Para obter mais informações, consulte Modificar grupos de funções.
Você só pode usar Exchange Online PowerShell para executar praticamente todos os procedimentos neste tópico (tudo, exceto ocultar destinatários de listas de endereços). Para se conectar ao PowerShell do Exchange Online, confira Conectar ao PowerShell do Exchange Online.
Dica
Está com problemas? Peça ajuda nos fóruns do Exchange. Visite os fóruns em Exchange Online ou Proteção do Exchange Online.
Usar o PowerShell do Exchange Online para criar listas de endereços
Você pode criar listas de endereços com ou sem filtros de destinatário. Para obter detalhes sobre filtros de destinatário, consulte Filtros de destinatário para listas de endereços no Exchange Online PowerShell.
Para criar uma lista de endereços, use a seguinte sintaxe:
New-AddressList -Name "<Address List Name>" [-Container <ExistingAddressListPath>] [<Precanned recipient filter | Custom recipient filter>] [-RecipientContainer <OrganizationalUnit>]
Este exemplo cria uma lista de endereços com um filtro de destinatário predefinido:
Nome: Escritórios do Sudeste
Local: na raiz ("
\", também conhecida como Todos os endereços Listas) porque não usamos o parâmetro Contêiner e o valor padrão é "\".Filtro de destinatário predefinido: todos os usuários com caixas de correio em que o valor do Estado ou da província é GA, AL ou LA (Geórgia, Alabama ou Louisiana).
New-AddressList -Name "Southeast Offices" -IncludedRecipients MailboxUsers -ConditionalStateorProvince "GA","AL","LA"
Este exemplo cria uma lista de endereços com um filtro de destinatário personalizado:
Nome: Executivos do Noroeste
Local: na lista de endereços existente chamada América do Norte.
Filtro de destinatário personalizado: todos os usuários com caixas de correio em que o valor título contém Director ou Manager, e o valor estado ou província é WA, OR ou ID (Washington, Oregon ou Idaho).
New-AddressList -Name "Northwest Executives" -Container "\North America"-RecipientFilter "(RecipientType -eq 'UserMailbox') -and (Title -like '*Director*' -or Title -like '*Manager*') -and (StateOrProvince -eq 'WA' -or StateOrProvince -eq 'OR' -or StateOrProvince -eq 'ID')"
For detailed syntax and parameter information, see New-AddressList.
Este exemplo cria a lista de endereços chamada Usuários de Oregon e Washington usando o parâmetro RecipientFilter e inclui destinatários que são usuários de caixa de correio e têm StateOrProvince definido como Washington ou Oregon.
New-AddressList -Name "Oregon and Washington" -RecipientFilter "((RecipientType -eq 'UserMailbox') -and ((StateOrProvince -eq 'Washington') -or (StateOrProvince -eq 'Oregon')))"
Este exemplo cria a lista de endereços filhas as salas de reunião do edifício 34 no contêiner todas as salas pai, usando as condições internas.
New-AddressList -Name "Building 34 Meeting Rooms" -Container "\All Rooms" -IncludedRecipients Resources -ConditionalCustomAttribute1 "Building 34"
Para detalhadas sobre sintaxe e informações de parâmetro, consulte New-AddressList.
Como saber se funcionou?
Para verificar se você criou com êxito uma lista de endereços, substitua <AddressListIdentity> pelo caminho\name da lista de endereços e execute o seguinte comando no Exchange Online Powershell para verificar os valores da propriedade:
Get-AddressList -Identity "<AddressListIdentity>" | Format-List Name,RecipientFilterType,RecipientFilter,IncludedRecipients,Conditional*
Usar Exchange Online Powershell para exibir membros de listas de endereços
Tecnicamente, esse procedimento retorna todos os destinatários (incluindo destinatários ocultos) que correspondem aos filtros do destinatário para a lista de endereços. Os destinatários que estão realmente visíveis na lista de endereços têm o valor Falseda propriedade HiddenFromAddressListsEnabled .
Para exibir os membros de uma lista de endereços, use a seguinte sintaxe:
$<VariableName> = Get-AddressList -Identity <AddressListIdentity>; Get-Recipient -ResultSize unlimited -RecipientPreviewFilter $<VariableName>.RecipientFilter | select Name,PrimarySmtpAddress,HiddenFromAddressListsEnabled
Este exemplo retorna os membros da lista de endereços chamada Sudeste Offices.
$AL = Get-AddressList -Identity "Southeast Offices"; Get-Recipient -ResultSize unlimited -RecipientPreviewFilter $AL.RecipientFilter | select Name,PrimarySmtpAddress,HiddenFromAddressListsEnabled
Este exemplo exporta os resultados para o arquivo C:\My Documents\Southeast Offices Export.csv.
$AL = Get-AddressList -Identity "Southeast Offices"; Get-Recipient -ResultSize unlimited -RecipientPreviewFilter $AL.RecipientFilter | select Name,PrimarySmtpAddress,HiddenFromAddressListsEnabled | Export-Csv -NoTypeInformation -Path "C:\My Documents\Southeast Offices Export.csv"
Usar Exchange Online PowerShell para atualizar listas de endereços
O cmdlet Update-AddressList (ou Update-GlobalAddressList) não está disponível no PowerShell do Exchange Online. Se os destinatários que devem aparecer uma lista de endereços não aparecerem, você precisará alterar o valor da propriedade necessário para esses usuários para um valor temporário e, em seguida, voltar para o valor exigido pela lista de endereços. Você pode atualizar os valores de propriedade do usuário no Centro de administração do Exchange (EAC) ou Exchange Online PowerShell, mas é mais rápido fazer operações em massa no PowerShell.
Por exemplo, suponha que a lista de endereços chamada Oregon e Washington Users use o filtro "((RecipientType -eq 'UserMailbox') -and ((StateOrProvince -eq 'Washington') -or (StateOrProvince -eq 'Oregon')))", mas a lista de endereços não inclui todos cujos valores de propriedade StateOrProvince são definidos corretamente. Para atualizar a lista de endereços, execute as seguintes etapas:
Use a consulta da lista de endereços para localizar todos os usuários que deveriam estar na lista de endereços. Por exemplo:
$Before = Get-User -Filter "((RecipientType -eq 'UserMailbox') -and ((StateOrProvince -eq 'Oregon') -or (StateOrProvince -eq 'Washington')))" -ResultSize UnlimitedAltere a propriedade required para um valor temporário. Por exemplo, altere os valores StateOrProvince de
OregonparaOR, eWashingtonparaWA:$Before | where {$_.StateOrProvince -eq 'Oregon'} | foreach {Set-User $_.Identity -StateOrProvince OR}$Before | where {$_.StateOrProvince -eq 'Washington'} | foreach {Set-User $_.Identity -StateOrProvince WA}Encontre os mesmos usuários novamente usando os valores de propriedade temporary. Por exemplo:
$After = Get-User -Filter "((RecipientType -eq 'UserMailbox') -and ((StateOrProvince -eq 'OR') -or (StateOrProvince -eq 'WA')))" -ResultSize UnlimitedAltere o valor temporário novamente para o valor necessário. Por exemplo, altere os valores StateOrProvince de
ORparaOregon, eWAparaWashington:$After | where {$_.StateOrProvince -eq 'OR'} | foreach {Set-User $_.Identity -StateOrProvince Oregon}$After | where {$_.StateOrProvince -eq 'WA'} | foreach {Set-User $_.Identity -StateOrProvince Washington}
Observações:
As propriedades de título, departamento e endereço exigem os cmdlets Get-User e Set-User . As propriedades de CustomAttribute1 CustomAttribute15 exigem os cmdlets Get-Mailbox e Set-Mailbox. Para obter mais informações sobre quais propriedades estão disponíveis em qual cmdlet, confira os seguintes tópicos:
Se um número pequeno apenas de usuários não aparecer na lista de endereços, você pode modificar o valor da propriedade required para cada usuário. Por exemplo:
Defina um valor de propriedade temporary para o usuário:
Set-User -Identity <UserIdentity> -StateOrProvince WAAltere o valor temporário novamente para o valor necessário:
Set-User -Identity <Identity> -StateOrProvince Washington
Como saber se funcionou?
Para verificar se você atualizou com êxito uma lista de endereços, substitua <AddressListIdentity> pelo nome da lista de endereços e execute o seguinte comando no Exchange Online PowerShell para verificar o valor da propriedade RecipientFilterApplied:
Get-AddressList -Identity <AddressListIdentity> | Format-Table Name,RecipientFilterApplied -Auto
Usar o PowerShell do Exchange Online para modificar listas de endereços
As mesmas configurações básicas estão disponíveis quando você cria a lista de endereços. Para obter mais informações, consulte a seção Usar Exchange Online PowerShell para criar listas de endereços neste tópico.
Para modificar uma lista de endereços existente, use a seguinte sintaxe:
Set-AddressList -Identity <AddressListIdentity> [-Name <Name>] [<Precanned recipient filter | Custom recipient filter>] [-RecipientContainer <OrganizationalUnit>]
Ao modificar os valores de parâmetro condicional , você pode usar a seguinte sintaxe para adicionar ou remover valores sem afetar outros valores existentes: @{Add="<Value1>","<Value2>"...; Remove="<Value1>","<Value2>"...}.
Este exemplo modifica a lista de endereços existente chamada Escritórios do Sudeste adicionando o valor de estado ou província TX (Texas) ao filtro de destinatário pre digitalizado.
Set-AddressList -Identity "Southeast Offices" -ConditionalStateOrProvince @{Add="TX"}
Para obter informações detalhadas sobre sintaxe e parâmetro, consulte Set-AddressList.
Como saber se funcionou?
Para verificar se você modificou com êxito uma lista de endereços, substitua <AddressListIdentity> pelo caminho\name da lista de endereços e execute o seguinte comando no Exchange Online Powershell para verificar os valores da propriedade:
Get-AddressList -Identity "<AddressListIdentity>" | Format-List Name,RecipientFilterType,RecipientFilter,IncludedRecipients,Conditional*
Usar o PowerShell do Exchange Online para excluir listas de endereços
Para remover uma lista de endereços, use a seguinte sintaxe:
Remove-AddressList -Identity "<AddressListName>"
Este exemplo remove a lista de endereços Sales Department, que não contém listas de endereços filhas.
Remove-AddressList -Identity "Sales Department"
Para informações detalhadas de sintaxes e de parâmetros, consulte Remove-AddressList.
Como saber se funcionou?
Para verificar se você removeu com êxito uma lista de endereços, execute o seguinte comando no Exchange Online Powershell para verificar se a lista de endereços não está listada:
Get-AddressList
Ocultar destinatários das listas de endereços
Ocultar um destinatário de listas de endereços não impede que o destinatário receba mensagens de email; impede que os usuários encontrem o destinatário em listas de endereços. O destinatário fica oculto de todas as de endereços e GALs (na verdade, eles são exceções para os filtros do destinatário em todas as listas de endereços). Se você quiser incluir, de forma seletiva, o destinatário em algumas listas de endereços mas não em outras, você deve ajustar os filtros de destinatário nas listas de endereços para incluir ou excluir o destinatário.
Usar o novo EAC para ocultar destinatários de listas de endereços
Para abrir o novo EAC, consulte Centro de administração do Exchange em Exchange Online.
Você não pode usar o novo EAC para ocultar grupos do Microsoft 365 de listas de endereços.
No novo EAC, vá para um dos seguintes locais com base no tipo de destinatário:
Destinatários>Caixas de correio: caixas de correio de usuário.
Destinatários>Grupos: grupos de distribuição, grupos de segurança habilitados para email e grupos de distribuição dinâmica.
Destinatários>Recursos: caixas de correio de sala e equipamentos.
Destinatários>Contatos: Usuários de email e contatos de email.
Pastas> públicasPastas públicas: pastas públicas habilitadas para email.
Selecione o destinatário que você deseja ocultar nas listas de endereços.
A janela de propriedades do destinatário é aberta. O que você faz agora depende do tipo de destinatário:
Caixas de correio: na guia Conta , selecione Gerenciar informações de contato. Em seguida, selecione Ocultar na lista de endereços globais.
Grupos: na guia Configurações, selecione Ocultar esse grupo na lista de endereços global.
Recursos: clique no lápis e selecione Ocultar nas listas de endereços (GAL).
Contatos: selecione Ocultar isso na lista de endereços globais.
Pastas públicas: na guia Propriedades gerais de email, selecione Ocultar das listas de endereços do Exchange.
Quando concluir, clique em Salvar.
Usar Exchange Online PowerShell para ocultar destinatários de listas de endereços
Para ocultar um destinatário de listas de endereços, use a seguinte sintaxe:
Set-<RecipientType> -Identity <RecipientIdentity> -HiddenFromAddressListsEnabled $true
<RecipientType> é um desses valores:
DistributionGroupDynamicDistributionGroupMailboxMailContactMailPublicFolderMailUserUnifiedGroup
Este exemplo oculta o grupo de distribuição chamado Assuntos Internos das listas de endereços.
Set-DistributionGroup -Identity "Internal Affairs" -HiddenFromAddressListsEnabled $true
Este exemplo oculta a caixa de correio michelle@contoso.com das listas de endereços.
Set-Mailbox -Identity michelle@contoso.com -HiddenFromAddressListsEnabled $true
Observação: para tornar o destinatário visível nas listas de endereços novamente, use o valor $false para o parâmetro HiddenFromAddressListsEnabled .
Como saber se funcionou?
Você pode verificar se escondeu com êxito um destinatário de listas de endereços usando qualquer um dos procedimentos a seguir:
No EAC, selecione o destinatário, clique em Editar (
) e verifique se a configuração ocultar das listas de endereços está selecionada.Em Exchange Online PowerShell, execute o seguinte comando e verifique se o destinatário está listado:
Get-Recipient -ResultSize unlimited -Filter 'HiddenFromAddressListsEnabled -eq $true'Abra o GAL no Outlook ou Outlook na Web (anteriormente conhecido como Outlook Web App) e verifique se o destinatário não está visível.