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 |