Update-SafeList
Este cmdlet está disponível somente no Exchange local.
Utilize o cmdlet Update-SafeList para atualizar os dados de agregação da lista segura no Active Directory. Os dados de agregação de listas seguras são utilizados na filtragem antisspesoal incorporada 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 (Padrão)
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 numa caixa de correio de utilizador do Microsoft Outlook e, em seguida, hashes e escreve os dados no objeto de utilizador 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 Seguros e a Lista de Destinatários Seguros do utilizador do Outlook.
Tenha em atenção o tráfego de rede e replicação que pode ser gerado quando executa o cmdlet Update-SafeList. A execução do comando em múltiplas caixas de correio onde as listas de segurança são muito utilizadas 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, poderá não ter acesso a alguns parâmetros se não estiverem incluídos nas permissões que lhe foram atribuídas. 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 Seguros para o único utilizador kim@contoso.com.
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 utilizador na sua organização do Exchange. Por predefinição, a Shell de Gestão do Exchange está configurada para obter ou modificar objetos que residem no domínio no qual o servidor Exchange reside. Por conseguinte, para obter todas as caixas de correio na sua organização do Exchange, primeiro tem de definir o âmbito da Shell de Gestão do Exchange para toda a floresta com o cmdlet Set-AdServerSettings.
Parâmetros
-Confirm
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
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, 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 confirmar 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
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
O comutador EnsureJunkEmailRule força a regra de e-mail de lixo 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
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 Utilizador
- 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
O comutador IncludeDomains especifica se pretende incluir os domínios do remetente especificados pelos utilizadores no Outlook 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 inclua domínios porque os utilizadores podem incluir os domínios de grandes fornecedores de serviços Internet (ISPs), que podem fornecer involuntariamente endereços que possam ser utilizados 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
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
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.
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 suporta os 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.