Compartilhar via

Update-SafeList (RTM)

  • Artigo

 

Aplica-se a: Exchange Server 2007

Tópico modificado em: 2008-06-17

Use o cmdlet Update-SafeList para atualizar os dados de agregação de lista segura no serviço de diretório do Active Directory. Os dados de agregação de lista segura são usados na filtragem anti-spam no Microsoft Exchange Server 2007. O EdgeSync replica os dados de agregação de lista segura em computadores em que a função de servidor Transporte de Borda esteja instalada.

O cmdlet Update-SafeList lê os dados de agregação de lista segura que são armazenados em uma caixa de correio de usuário do Microsoft Office Outlook e especifica como hash e grava os dados no objeto de usuário correspondente no Active Directory. Os dados de agregação de lista segura contém a Lista de Remetentes Seguros e a Lista de Destinatários Seguros do usuário do Outlook.

Você usa o parâmetro Type para especificar se atualiza a Lista de Remetentes Seguros e/ou a Lista de Destinatários Seguros do usuário do Outlook. No entanto, apenas os dados da Lista de Remetentes Seguros são usados pelo recurso de agregação de lista segura, o qual não atua nos dados da Lista de Destinatários Seguros. Portanto, para reduzir o excesso de replicação e armazenamento no Active Directory, não recomendamos executar o parâmetro Type com os valores SafeRecipients ou Both no Exchange 2007. O valor padrão do parâmetro Type é SafeSenders.

Para obter mais informações sobre como funciona a agregação de lista segura, consulte Agregação de lista segura.

Sintaxe

Update-SafeList -Identity <MailboxIdParameter> [-DomainController <Fqdn>] [-Type <SafeSenders | SafeRecipients | Both>]

Descrição detalhada

Para executar o cmdlet Update-SafeList, você deve usar a conta à qual esteja delegado o seguinte:

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

  • Função Administrador de Destinatários 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

Identity

Necessário

Microsoft.Exchange.Configuration.Tasks.MailboxIdParameter

Use esse parâmetro para especificar a caixa de correio de usuário do Outlook a partir da qual você deseja coletar dados de agregação de lista segura. A entrada válida para esse parâmetro inclui os seguintes valores:

  • GUID

  • DN (nome distinto)

  • Domínio\Conta

  • UPN

  • LegacyExchangeDN

  • SmtpAddress

  • Alias

DomainController

Opcional

Microsoft.Exchange.Data.Fqdn

Para especificar o nome de domínio totalmente qualificado (FQDN) do controlador de domínio que grava essa alteração de configuração no Active Directory, inclua o parâmetro DomainController no comando. O parâmetro DomainController não tem suporte em computadores em que a função de servidor Transporte de Borda está instalada. A função de servidor Transporte de Borda grava somente na instância local do Active Directory Application Mode (ADAM).

Tipo

Opcional

Microsoft.Exchange.Management.RecipientTasks.UpdateType

Use esse parâmetro para especificar qual lista gerada pelo usuário é atualizada para o objeto de usuário. Os valores válidos para esse parâmetro são SafeSenders, SafeRecipients e Both. O valor padrão é SafeSenders.

Importante

No Exchange 2007, o recurso de agregação de lista segura não atua sobre os dados da Lista de Destinatários Seguros. Não recomendamos executar o parâmetro Type com os valores SafeRecipients ou Both.

Tipos de entrada

Tipos de retorno

Erros

Erro Descrição

 

 

Exceções

Exceções Descrição

 

 

Exemplo

O primeiro exemplo mostra como atualizar dados da Lista de Remetentes Seguros de um único usuário, KimA, usando o cmdlet Update-SafeList.

O segundo exemplo mostra como atualizar todos os dados da lista segura de todos os usuários da caixa de correio na organização do Exchange. Por padrão, o Shell de Gerenciamento do Exchange está configurado para recuperar ou modificar objetos que residam no domínio em que o servidor do Exchange reside. Portanto, para recuperar todas as caixas de correio em sua organização do Exchange, você deve definir o valor de $AdminSessionAdSettings.ViewEntireForest como $True. Então é possível executar o cmdlet Get-Mailbox e canalizar o resultado para o cmdlet Update-Safelist para atualizar todos os dados de lista segura de todos os usuários de caixa de correio na organização do Exchange.

Aviso

Quando você modifica o valor de $AdminSessionAdSettings.ViewEntireForest, o novo valor permanece até que você feche a sessão atual do Shell de Gerenciamento do Exchange. Recomendamos que você defina o $AdminSessionAdSettings.ViewEntireForest como $False imediatamente depois de executar a tarefa para evitar modificar ou recuperar sem intenção objetos além do escopo pretendido.

Update-Safelist -Identity KimA 
AdminSessionAdSettings.ViewEntireForest = $True
get-mailbox  -ResultSize Unlimited | where {$_.RecipientType -eq [Microsoft.Exchange.Data.Directory.Recipient.RecipientType]::UserMailbox } | update-safelist