New-QuarantinePolicy

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

Use o cmdlet New-QuarantinePolicy para criar 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

New-QuarantinePolicy
   [-Name] <String>
   [-AdminDisplayName <String>]
   [-AdminNotificationFrequencyInDays <Int32>]
   [-AdminNotificationLanguage <EsnLanguage>]
   [-AdminNotificationsEnabled <Boolean>]
   [-AdminQuarantinePermissionsList <MultiValuedProperty>]
   [-CustomDisclaimer <String>]
   [-DomainController <Fqdn>]
   [-EndUserQuarantinePermissions <QuarantinePermissions>]
   [-EndUserQuarantinePermissionsValue <Int32>]
   [-EndUserSpamNotificationCustomFromAddress <String>]
   [-EndUserSpamNotificationFrequency <TimeSpan>]
   [-EndUserSpamNotificationFrequencyInDays <Int32>]
   [-EndUserSpamNotificationLanguage <EsnLanguage>]
   [-EsnCustomSubject <MultiValuedProperty>]
   [-ESNEnabled <Boolean>]
   [-MultiLanguageCustomDisclaimer <MultiValuedProperty>]
   [-MultiLanguageSenderName <MultiValuedProperty>]
   [-MultiLanguageSetting <MultiValuedProperty>]
   [-OrganizationBrandingEnabled <Boolean>]
   [-QuarantinePolicyType <QuarantinePolicyType>]
   [-QuarantineRetentionDays <Int32>]
   [<CommonParameters>]

Description

As políticas de quarentena definem o que os usuários podem fazer com mensagens em quarentena com base no motivo pelo qual a mensagem foi colocada em quarentena (para recursos compatíveis) e configurações de notificação de quarentena. Para obter mais informações, confira Políticas de quarentena.

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

New-QuarantinePolicy -Name ContosoTag -EndUserQuarantinePermissionsValue 0

Este exemplo cria uma nova política de quarentena chamada ContosoTag com as mesmas permissões que o grupo de permissões sem predefinição de acesso.

Para atribuir permissões de acesso limitado, use o valor 27. Para atribuir permissões de acesso completo, use o valor 23.

Parâmetros

-AdminDisplayName

O parâmetro AdminDisplayName especifica uma descrição da política de quarentena. Se o valor contiver espaços, coloque-o entre aspas (").

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

-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

-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 $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: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.

Se você não usar esse parâmetro, o remetente padrão será quarantine@messaging.microsoft.com.

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 ver 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

-MultiLanguageCustomDisclaimer

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

-MultiLanguageSenderName

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

-MultiLanguageSetting

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

-Name

O parâmetro Name especifica um nome exclusivo para a política de quarentena. Se o valor contiver espaços, coloque-o entre aspas (").

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

-OrganizationBrandingEnabled

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

-QuarantinePolicyType

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

Type:QuarantinePolicyType
Accepted values:QuarantinePolicy, GlobalQuarantinePolicy
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