Set-QuarantinePolicy

Esse cmdlet só está disponível no serviço baseado em nuvem.

Use o cmdlet Set-QuarantinePolicy para modificar políticas de quarentena em sua organização baseada em nuvem.

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

Syntax

Set-QuarantinePolicy
   [-Identity] <QuarantineTagIdParameter>
   [-AdminNotificationFrequencyInDays <Int32>]
   [-AdminNotificationLanguage <EsnLanguage>]
   [-AdminNotificationsEnabled <Boolean>]
   [-AdminQuarantinePermissionsList <MultiValuedProperty>]
   [-Confirm]
   [-CustomDisclaimer <String>]
   [-DomainController <Fqdn>]
   [-EndUserQuarantinePermissions <QuarantinePermissions>]
   [-EndUserQuarantinePermissionsValue <Int32>]
   [-EndUserSpamNotificationCustomFromAddress <String>]
   [-EndUserSpamNotificationFrequency <TimeSpan>]
   [-EndUserSpamNotificationFrequencyInDays <Int32>]
   [-EndUserSpamNotificationLanguage <EsnLanguage>]
   [-EsnCustomSubject <MultiValuedProperty>]
   [-ESNEnabled <Boolean>]
   [-IgnoreDehydratedFlag]
   [-MultiLanguageCustomDisclaimer <MultiValuedProperty>]
   [-MultiLanguageSenderName <MultiValuedProperty>]
   [-MultiLanguageSetting <MultiValuedProperty>]
   [-OrganizationBrandingEnabled <Boolean>]
   [-QuarantineRetentionDays <Int32>]
   [-WhatIf]
   [<CommonParameters>]

Description

Você não pode modificar as políticas de quarentena internas chamadas AdminOnlyAccessPolicy ou DefaultFullAccessPolicy.

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

Set-QuarantinePolicy -Identity CustomAccess -EndUserQuarantinePermissionsValue 1

Este exemplo configura as permissões na política de quarentena chamada CustomAccess que permite que os usuários excluam mensagens em quarentena.

Exemplo 2

Get-QuarantinePolicy -QuarantinePolicyType GlobalQuarantinePolicy | Set-QuarantinePolicy -MultiLanguageSetting ('English','ChineseSimplified','French') -MultiLanguageCustomDisclaimer ('For more information, contact the Help Desk.','有关更多信息,请联系服务台','Pour plus d''informations, contactez le service d''assistance.') -ESNCustomSubject ('You have quarantined messages','您有隔离邮件','Vous avez des messages en quarantaine') -MultiLanguageSenderName ('Contoso administrator','Contoso管理员','Administrateur Contoso') -EndUserSpamNotificationCustomFromAddress aashutosh@contso.onmicrosoft.com -OrganizationBrandingEnabled $true -EndUserSpamNotificationFrequency 04:00:00

Este exemplo modifica as configurações globais para notificações de quarentena (anteriormente conhecidas como configurações de notificação de spam do usuário final):

  • As notificações de quarentena são personalizadas para inglês, chinês e francês. Aspas extras são necessárias no valor multilanguagecustomDisclaimer francês como caracteres de escape para os caracteres de marca de cotação no texto.
  • O usuário aashutosh@contso.onmicrosoft.com existente é usado como o remetente de notificação de quarentena.
  • O logotipo personalizado configurado anteriormente substitui o logotipo padrão da Microsoft.
  • A frequência de notificações de quarentena é alterada para 4 horas.

Parâmetros

-AdminNotificationFrequencyInDays

Esse parâmetro está reservado para uso interno da Microsoft.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-AdminNotificationLanguage

Esse parâmetro está reservado para uso interno da Microsoft.

Type:EsnLanguage
Accepted values:Default, English, French, German, Italian, Japanese, Spanish, Korean, Portuguese, Russian, ChineseSimplified, ChineseTraditional, Amharic, Arabic, Bulgarian, BengaliIndia, Catalan, Czech, Cyrillic, Danish, Greek, Estonian, Basque, Persian, Finnish, Filipino, Galician, Gujarati, Hebrew, Hindi, Croatian, Hungarian, Indonesian, Icelandic, Kazakh, Kannada, Lithuanian, Latvian, Malayalam, Marathi, Malay, Dutch, NorwegianNynorsk, Norwegian, Odia, Polish, PortuguesePortugal, Romanian, Slovak, Slovenian, SerbianCyrillic, Serbian, Swedish, Swahili, Tamil, Telugu, Thai, Turkish, Ukrainian, Urdu, Vietnamese
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-AdminNotificationsEnabled

Esse parâmetro está reservado para uso interno da Microsoft.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-AdminQuarantinePermissionsList

Esse parâmetro está reservado para uso interno da Microsoft.

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-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 esses cmdlets, você pode ignorar a solicitação 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 Online, Exchange Online Protection

-CustomDisclaimer

Esse parâmetro está reservado para uso interno da Microsoft.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-DomainController

Esse parâmetro está reservado para uso interno da Microsoft.

Type:Fqdn
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-EndUserQuarantinePermissions

Esse parâmetro está reservado para uso interno da Microsoft.

Type:QuarantinePermissions
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-EndUserQuarantinePermissionsValue

O parâmetro EndUserQuarantinePermissionsValue especifica as permissões do usuário final para a política de quarentena.

Esse parâmetro usa um valor decimal convertido de um valor binário. O valor binário corresponde à lista de permissões disponíveis em uma ordem específica. Para cada permissão, o valor 1 é igual a True e o valor 0 é igual a False. A ordem necessária é descrita na lista a seguir da mais alta (1000000 ou 128) para a mais baixa (00000001 ou 1):

  • PermissionToViewHeader: o valor 0 não oculta a ação Exibir cabeçalho de mensagem em quarentena. Se a mensagem estiver visível em quarentena, a ação estará sempre disponível para a mensagem.
  • PermissionToDownload: essa permissão não é usada (o valor 0 ou 1 não faz nada).
  • PermissionToAllowSender: essa permissão não é usada (o valor 0 ou 1 não faz nada).
  • PermissionToBlockSender
  • PermissionToRequestRelease: não defina essa permissão e PermissionToRelease como o valor 1. Defina um valor como 1 e o outro valor como 0 ou defina ambos os valores como 0.
  • PermissionToRelease: não defina essa permissão e PermissionToRequestRelease como valor 1. Defina um valor como 1 e o outro valor como 0 ou defina ambos os valores como 0. Essa permissão não é honrada para mensagens que foram colocadas em quarentena como malware ou phishing de alta confiança. Se a política de quarentena fornecer essa permissão aos usuários, os usuários poderão solicitar a liberação de seu malware em quarentena ou mensagens de phishing de alta confiança como se PermissionToRequestRelease fosse selecionado.
  • PermissionToPreview
  • PermissionToDelete

Os valores para os grupos de permissão do usuário final predefinidos são descritos na seguinte lista:

  • Sem acesso: Binário = 0000000, portanto, use o valor decimal 0.
  • Acesso limitado: Binário = 00011011, portanto, use o valor decimal 27.
  • Acesso completo: Binário = 00010111, portanto, use o valor decimal 23.

Para permissões personalizadas, obtenha o valor binário que corresponde às permissões desejadas. Converta o valor binário em um valor decimal a ser usado. Não use o valor binário para este parâmetro.

Observação: se o valor desse parâmetro for 0 (sem acesso) e o valor do parâmetro ESNEnabled for $true, os usuários poderão exibir suas mensagens em quarentena, mas a única ação disponível para as mensagens é Exibir cabeçalho de mensagem.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-EndUserSpamNotificationCustomFromAddress

O EndUserSpamNotificationCustomFromAddress especifica o endereço de email de um remetente interno existente a ser usado como remetente para notificações de quarentena. Para definir esse parâmetro de volta para o endereço quarantine@messaging.microsoft.comde email padrão, use o valor $null.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-EndUserSpamNotificationFrequency

A espécie de parâmetro EndUserSpamNotificationFrequency com que frequência as notificações de quarentena são enviadas aos usuários. Os valores válidos são:

  • 04:00:00 (4 horas)
  • 1.00:00:00 (1 dia)
  • 7:00:00:00 (7 dias)
Type:TimeSpan
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-EndUserSpamNotificationFrequencyInDays

Esse parâmetro está reservado para uso interno da Microsoft.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-EndUserSpamNotificationLanguage

Esse parâmetro está reservado para uso interno da Microsoft.

Type:EsnLanguage
Accepted values:Default, English, French, German, Italian, Japanese, Spanish, Korean, Portuguese, Russian, ChineseSimplified, ChineseTraditional, Amharic, Arabic, Bulgarian, BengaliIndia, Catalan, Czech, Cyrillic, Danish, Greek, Estonian, Basque, Persian, Finnish, Filipino, Galician, Gujarati, Hebrew, Hindi, Croatian, Hungarian, Indonesian, Icelandic, Kazakh, Kannada, Lithuanian, Latvian, Malayalam, Marathi, Malay, Dutch, NorwegianNynorsk, Norwegian, Odia, Polish, PortuguesePortugal, Romanian, Slovak, Slovenian, SerbianCyrillic, Serbian, Swedish, Swahili, Tamil, Telugu, Thai, Turkish, Ukrainian, Urdu, Vietnamese
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-EsnCustomSubject

O parâmetro EsnCustomSubject especifica o texto a ser usado no campo Assunto de notificações de quarentena.

Você pode especificar vários valores separados por vírgulas usando a sintaxe: ('value1',''value2',...'valueN'). Para cada idioma especificado com o parâmetro MultiLanguageSetting, você precisa especificar texto exclusivo do Remetente. Alinhe os valores de parâmetro MultiLanguageSetting, MultiLanguageCustomDisclaimer, EsnCustomSubject e MultiLanguageSenderName na mesma ordem.

Para modificar um valor existente e preservar outros valores, você precisa especificar todos os valores existentes e o novo valor na ordem existente.

Essa configuração está disponível apenas na política de quarentena interna chamada DefaultGlobalTag que controla as configurações de política de quarentena global. Para acessar essa política de quarentena, inicie seu comando com a seguinte sintaxe: Get-QuarantinePolicy -QuarantinePolicyType GlobalQuarantinePolicy | Set-QuarantinePolicy ....

Type:undefined
Aliases:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-ESNEnabled

O parâmetro ESNEnabled especifica se é possível habilitar notificações de quarentena (anteriormente conhecidas como notificações de spam do usuário final) para a política. Os valores válidos são:

  • $true: as notificações de quarentena estão habilitadas.
  • $false: as notificações de quarentena estão desabilitadas. O usuário só pode acessar mensagens em quarentena em quarentena, não em notificações por email. Esse é o valor padrão.

Observação: se o valor desse parâmetro for $true e o valor do parâmetro EndUserQuarantinePermissionsValue for 0 (sem acesso em que todas as permissões estão desativadas), os usuários poderão exibir suas mensagens em quarentena, mas a única ação disponível para as mensagens é Exibir cabeçalho de mensagem.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-Identity

O parâmetro Identity especifica a política de quarentena que você deseja modificar. Você pode usar qualquer valor que identifique exclusivamente a política de quarentena. Por exemplo:

  • Nome
  • DN (nome diferenciado)
  • GUID
Type:QuarantineTagIdParameter
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-IgnoreDehydratedFlag

Esse parâmetro está reservado para uso interno da Microsoft.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-MultiLanguageCustomDisclaimer

O parâmetro MultiLanguageCustomDisclaimer especifica o texto de isenção de responsabilidade personalizado a ser usado perto da parte inferior das notificações de quarentena. O texto localizado, Um aviso de isenção de responsabilidade de sua organização: é sempre incluído primeiro, seguido pelo texto que você especifica para este parâmetro.

Você pode especificar vários valores separados por vírgulas usando a sintaxe: ('value1',''value2',...'valueN'). Para cada idioma especificado com o parâmetro MultiLanguageSetting, você precisa especificar um texto de isenção de responsabilidade personalizado exclusivo. Alinhe os valores de parâmetro MultiLanguageSetting, MultiLanguageCustomDisclaimer, EsnCustomSubject e MultiLanguageSenderName na mesma ordem.

Para modificar um valor existente e preservar outros valores, você precisa especificar todos os valores existentes e o novo valor na ordem existente.

Essa configuração está disponível apenas na política de quarentena interna chamada DefaultGlobalTag que controla as configurações de política de quarentena global. Para acessar essa política de quarentena, inicie seu comando com a seguinte sintaxe: Get-QuarantinePolicy -QuarantinePolicyType GlobalQuarantinePolicy | Set-QuarantinePolicy ....

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-MultiLanguageSenderName

O parâmetro MultiLanguageSenderName especifica o nome de exibição do remetente de email a ser usado em notificações de quarentena.

Você pode especificar vários valores separados por vírgulas usando a sintaxe: ('value1',''value2',...'valueN'). Para cada idioma especificado com o parâmetro MultiLanguageSetting, você pode especificar um nome de remetente exclusivo. Certifique-se de alinhar os valores de parâmetro MultiLanguageSetting, MultiLanguageCustomDisclaimer e MultiLanguageSenderName correspondentes na mesma ordem.

Para modificar um valor existente e preservar outros valores, você precisa especificar todos os valores existentes e o novo valor na ordem existente.

Essa configuração está disponível apenas na política de quarentena interna chamada DefaultGlobalTag que controla as configurações globais. Para acessar essa política de quarentena, inicie seu comando com a seguinte sintaxe: Get-QuarantinePolicy -QuarantinePolicyType GlobalQuarantinePolicy | Set-QuarantinePolicy ....

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-MultiLanguageSetting

O parâmetro MultiLanguageSetting especifica o idioma das notificações de quarentena. Os valores válidos são:

Padrão, amárico, árabe, basco, bengaliindia, búlgaro, catalão, chinês simplificado, chinêsTraditional, croata, cirílico, Tcheco, dinamarquês, holandês, inglês, estoniano, filipino, finlandês, francês, galeciano, alemão, grego, Gujarati, hebraico, hindi, húngaro, islandês, indonésio, italiano, japonês, kannada, cazaque, coreano, letão, lituano, malaio, malaia, Marathi, norueguês, norueguêsNynorsk, Odia, persa, polonês, português, português, romeno, russo, sérvio, sérvio Eslovaco, esloveno, espanhol, suaíli, sueco, tâmil, Telugu, tailandês, turco, ucraniano, urdu e vietnamita.

Você pode especificar vários valores separados por vírgulas usando a sintaxe: ('value1',''value2',...'valueN'). O valor padrão é Default, o que significa que as notificações de quarentena usam o idioma padrão da organização baseada em nuvem.

Para cada idioma especificado, você pode especificar um valor exclusivo para os parâmetros MultiLanguageCustomDisclaimer e MultiLanguageSenderName. Certifique-se de alinhar os valores de parâmetro MultiLanguageSetting, MultiLanguageCustomDisclaimer e MultiLanguageSenderName correspondentes na mesma ordem.

Essa configuração está disponível apenas na política de quarentena interna chamada DefaultGlobalTag que controla as configurações globais. Para acessar essa política de quarentena, inicie seu comando com a seguinte sintaxe: Get-QuarantinePolicy -QuarantinePolicyType GlobalQuarantinePolicy | Set-QuarantinePolicy ....

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-OrganizationBrandingEnabled

O parâmetro OrganizationBrandingEnabled habilita ou desabilita a identidade visual da organização nas mensagens de notificação de quarentena do usuário final. Os valores válidos são:

  • $true: a identidade visual da organização está habilitada. O logotipo padrão da Microsoft usado em notificações de quarentena é substituído pelo logotipo personalizado. Antes de fazer isso, você precisa seguir as instruções em Personalizar o tema do Microsoft 365 para sua organização carregar seu logotipo personalizado.
  • $false: A identidade visual da organização está desabilitada. O logotipo padrão da Microsoft é usado em notificações de quarentena. Esse é o valor padrão.

Essa configuração está disponível apenas na política de quarentena interna chamada DefaultGlobalTag que controla as configurações globais. Para acessar essa política de quarentena, inicie seu comando com a seguinte sintaxe: Get-QuarantinePolicy -QuarantinePolicyType GlobalQuarantinePolicy | Set-QuarantinePolicy ....

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-QuarantineRetentionDays

Esse parâmetro está reservado para uso interno da Microsoft.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-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 Online, Exchange Online Protection