Update-SafeList
Este cmdlet está disponível somente no Exchange local.
Use o cmdlet Update-SafeList para atualizar os dados de agregação da lista segura no Active Directory. Os dados de agregação de lista segura são usados na filtragem antispam 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.
Sintaxe
Default (Default)
Update-SafeList
[-Identity] <MailboxIdParameter>
[-Confirm]
[-DomainController <Fqdn>]
[-EnsureJunkEmailRule]
[-IncludeDomains]
[-Type <UpdateType>]
[-WhatIf]
[<CommonParameters>]
Description
O cmdlet Update-SafeList lê os dados de agregação da lista segura armazenados em uma caixa de correio do usuário do Microsoft Outlook e, em seguida, faz hash 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 da lista segura contêm a Lista de Remetentes Confiáveis e a Lista de Destinatários Confiáveis do usuário do Outlook.
Lembre-se do tráfego de rede e de replicação que pode ser gerado quando você executa o cmdlet Update-SafeList. Executar o comando em várias caixas de correio onde as listas seguras são muito usadas pode gerar uma quantidade significativa de tráfego. 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 artigo 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 os dados da Lista de Remetentes Confiáveis 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 os dados da lista segura para todas as caixas de correio de 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 Exchange server reside. Portanto, para recuperar todas as caixas de correio em sua organização do Exchange, você deve primeiro definir o escopo do Shell de Gerenciamento do Exchange para toda a floresta usando o cmdlet Set-AdServerSettings.
Parâmetros
-Confirm
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
A opção Confirm especifica se a solicitação de confirmação deve ser mostrada ou ocultada. A forma como essa opção afeta o cmdlet depende se o cmdlet requer confirmação antes de continuar.
- Cmdlets destrutivos (por exemplo, Remover- cmdlets) têm uma pausa interna que força você a confirmar o comando antes de continuar. Para estes cmdlets, você pode pular o pedido de confirmação usando esta sintaxe exata:
-Confirm:$false. - A maioria dos outros cmdlets (por exemplo, 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 reconhecer o comando antes de continuar.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | cf |
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 |
-DomainController
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
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 |
-EnsureJunkEmailRule
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
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.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| 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
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)
- Domínio\Nome de usuário
- Endereço de email
- GUID
- LegacyExchangeDN
- SamAccountName
- ID de usuário ou nome UPN
Propriedades do parâmetro
| Tipo: | MailboxIdParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 1 |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
-IncludeDomains
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
A opção IncludeDomains especifica se os domínios de remetente especificados pelos usuários no Outlook devem ser incluídos nos dados de agregação da lista segura. 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 recomendamos que você inclua domínios, pois os usuários podem incluir os domínios de grandes ISPs (provedores de serviços de Internet), que podem, involuntariamente, fornecer endereços que podem ser usados ou falsificados por spammers.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| 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 |
-Type
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
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.
Propriedades do parâmetro
| Tipo: | UpdateType |
| 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 |
-WhatIf
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
A opção WhatIf mostra o que o comando faz sem fazer nenhuma alteração. Não é preciso especificar um valor com essa opção.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | wi |
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 |
CommonParameters
Este cmdlet dá suporte aos 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.