Update-SafeList
Aplica-se a: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
Tópico modificado em: 2008-07-18
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> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-IncludeDomains <SwitchParameter>] [-Type <SafeSenders | SafeRecipients | Both>] [-WhatIf [<SwitchParameter>]]
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 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:
|
Confirm |
Opcional |
System.Management.Automation.SwitchParameter |
O parâmetro Confirm faz com que o comando pause o processamento e exige que você confirme o que o comando fará antes que o processamento continue. Você não precisa especificar um valor com o parâmetro Confirm. |
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 Modo de Aplicativo do Active Directory (ADAM). |
IncludeDomains |
Opcional |
System.Management.Automation.SwitchParameter |
Use esse parâmetro se desejar incluir os domínios de remetente especificados por usuários do Outlook nas listas de segurança agregadas. Por padrão, os domínios especificados pelos remetentes não são incluídos. Na maioria dos casos, não é recomendável que você inclua domínios, pois os usuários podem incluir os domínios de grandes provedores de serviço de Internet (ISP), que poderiam fornecer não intencionalmente endereços que podem ser usados ou falsificados por spammers. |
Type |
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 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 |
WhatIf |
Opcional |
System.Management.Automation.SwitchParameter |
O parâmetro WhatIf instrui o comando a simular as ações que ele executará no objeto. Ao usar o parâmetro WhatIf, você poderá exibir quais alterações ocorrerão sem precisar aplicar nenhuma dessas alterações. Você não precisa especificar um valor com o parâmetro WhatIf. |
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