Update-SafeList

Referência

Módulo:: ExchangePowerShell

Aplica-se a:: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

Este cmdlet está disponível somente no Exchange local.

Use o cmdlet Update-SafeList para atualizar os dados de agregação de lista de segurança no Active Directory. Os dados de agregação de lista de segurança são usados na filtragem anti-spam interna no Microsoft Exchange. O EdgeSync replica dados de agregação de lista segura para servidores de Transporte de Borda no perímetro da rede.

Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax.

Syntax

Update-SafeList
      [-Identity] <MailboxIdParameter>
      [-Confirm]
      [-DomainController <Fqdn>]
      [-EnsureJunkEmailRule]
      [-IncludeDomains]
      [-Type <UpdateType>]
      [-WhatIf]
      [<CommonParameters>]

Description

O cmdlet Update-SafeList lê os dados de agregação de lista de segurança armazenados em uma caixa de correio de usuário do Microsoft Outlook e, em seguida, hashes e grava os dados no objeto de usuário correspondente no Active Directory. O comando compara o atributo binário criado para qualquer valor armazenado no atributo. Se os dois valores forem idênticos, o comando não atualizará o valor do atributo do usuário com os dados de agregação da lista segura. Os dados de agregação de lista de segurança contêm a Lista de Remetentes Seguros e a Lista de Destinatários Seguros do usuário do Outlook.

Preste atenção ao tráfego que pode ser gerado na rede e durante a replicação ao executar o cmdlet Update-SafeList. Executar o comando em várias caixas de correio em que listas seguras sejam muito usadas poderá gerar um volume de tráfego significativo. Recomendamos que, se você executar o comando em vários caixas de correio, você o execute durante os horários não comerciais, fora do pico.

Para executar esse cmdlet, você precisa ter permissões. Embora este tópico liste todos os parâmetros do cmdlet, talvez você não tenha acesso a alguns parâmetros se eles não estiverem incluídos nas permissões atribuídas a você. 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

Update-Safelist kim@contoso.com

Este exemplo atualiza dados da Lista de Remetentes Seguros para o usuário kim@contoso.comúnico .

Exemplo 2

Set-AdServerSettings -ViewEntireForest $true

Get-Mailbox -ResultSize Unlimited -RecipientTypeDetails UserMailbox | Update-Safelist

Este exemplo atualiza dados de lista de segurança para todas as caixas de correio do usuário em sua organização do Exchange. Por padrão, o Shell de Gerenciamento do Exchange é configurado para recuperar ou modificar objetos que residem no domínio no qual o servidor exchange reside. Portanto, para recuperar todas as caixas de correio em sua organização do Exchange, primeiro você deve definir o escopo do Shell de Gerenciamento do Exchange para toda a floresta usando o cmdlet Set-AdServerSettings.

Parâmetros

-Confirm

A opção Confirm especifica se a solicitação de confirmação deve ser mostrada ou ocultada. Como essa opção afeta o cmdlet dependerá do fato de o cmdlet exigir ou não confirmação antes de continuar.

Cmdlets destrutivos (por exemplo, cmdlets Remove-*) têm uma pausa interna que força você a reconhecer o comando antes de prosseguir. Para estes cmdlets, você pode pular o pedido de confirmação usando esta sintaxe exata: -Confirm:$false.
A maioria dos outros cmdlets (por exemplo, cmdlets New-* e Set-*) não tem uma pausa interna. Para esses cmdlets, especificar a opção Confirm sem um valor introduz uma pausa que força você a confirmar o comando antes de continuar.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-DomainController

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.

Type:	Fqdn
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-EnsureJunkEmailRule

A opção EnsureJunkEmailRule força a regra de lixo eletrônico a ser ativada para a caixa de correio se a regra ainda não estiver ativada. Não é preciso especificar um valor com essa opção.

A regra de lixo eletrônico só pode ser criada depois que o usuário faz logon na caixa de correio. Se o usuário nunca tiver feito logon na caixa de correio, esse parâmetro não poderá ativar a regra de lixo eletrônico.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Identity

O parâmetro Identity especifica a caixa de correio de usuário da qual você deseja coletar dados de agregação de lista segura. É possível usar qualquer valor que identifique a caixa de correio exclusivamente. Por exemplo:

Nome
Alias
Nome diferenciado (DN)
Nome diferenciado (DN)
Domain\username
Endereço de email
GUID
LegacyExchangeDN
SamAccountName
ID de usuário ou nome UPN

Type:	MailboxIdParameter
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-IncludeDomains

A opção IncludeDomains especifica se deve incluir os domínios de remetente especificados pelos usuários no Outlook nos dados de agregação de lista de segurança. Não é preciso especificar um valor com essa opção.

Por padrão, domínios especificados pelos remetentes não são incluídos.

Na maioria dos casos, não é recomendável incluir domínios, pois os usuários podem incluir os domínios de grandes provedores de serviços de Internet (ISPs), que podem fornecer inadvertidamente endereços que podem ser usados ou falsificados por remetentes de spam.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Type

O parâmetro Type especifica qual lista gerada pelo usuário será 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.

O recurso de agregação de lista segura não atua sobre os dados da Lista de Destinatários Confiáveis. Não é recomendável executar o parâmetro Type com os valores SafeRecipients ou Both.

Type:	UpdateType
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-WhatIf

A opção WhatIf simula as ações do comando. Você pode usar essa opção para exibir as alterações que ocorreriam sem realmente aplicar essas alterações. Não é preciso especificar um valor com essa opção.

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

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.