Compartir a través de


New-QuarantinePolicy

Este cmdlet solo está disponible en el servicio basado en la nube.

Use el cmdlet New-QuarantinePolicy para crear directivas de cuarentena en la organización basada en la nube.

Para obtener más información acerca de los conjuntos de parámetros de la sección Sintaxis a continuación, vea Sintaxis del cmdlet de Exchange.

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

Las directivas de cuarentena definen lo que los usuarios pueden hacer en los mensajes en cuarentena en función de por qué se puso en cuarentena el mensaje (para las características admitidas) y la configuración de la notificación de cuarentena. Para más información, vea Directivas de cuarentena.

Deberá tener asignados permisos antes de poder ejecutar este cmdlet. Aunque en este tema se enumeran todos los parámetros correspondientes a este cmdlet, tal vez no tenga acceso a algunos parámetros si no están incluidos en los permisos que se le han asignado. Para obtener los permisos necesarios para ejecutar cualquier cmdlet o parámetro en su organización, consulte Find the permissions required to run any Exchange cmdlet.

Ejemplos

Ejemplo 1

New-QuarantinePolicy -Name ContosoTag -EndUserQuarantinePermissionsValue 0

En este ejemplo se crea una nueva directiva de cuarentena denominada ContosoTag con los mismos permisos que el grupo Sin permisos preestablecidos de acceso.

Para asignar permisos de acceso limitado, use el valor 27. Para asignar permisos de acceso completo, use el valor 23.

Parámetros

-AdminDisplayName

El parámetro AdminDisplayName especifica una descripción para la directiva de cuarentena. Si el valor contiene espacios, escriba el valor entre comillas (").

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

Este parámetro está reservado para uso interno de 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

Este parámetro está reservado para uso interno de 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

Este parámetro está reservado para uso interno de 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

Este parámetro está reservado para uso interno de 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

Este parámetro está reservado para uso interno de 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

Este parámetro está reservado para uso interno de 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

Este parámetro está reservado para uso interno de 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

El parámetro EndUserQuarantinePermissionsValue especifica los permisos del usuario final para la directiva de cuarentena.

Este parámetro usa un valor decimal que se convierte a partir de un valor binario. El valor binario corresponde a la lista de permisos disponibles en un orden específico. Para cada permiso, el valor 1 es igual a True y el valor 0 es False. El orden requerido se describe en la lista siguiente de más alto (1000000 o 128) a más bajo (00000001 o 1):

  • PermissionToViewHeader: el valor 0 no oculta la acción Ver encabezado del mensaje en cuarentena. Si el mensaje está visible en cuarentena, la acción siempre estará disponible para el mensaje.
  • PermissionToDownload: este permiso no se usa (el valor 0 o 1 no hace nada).
  • PermissionToAllowSender: este permiso no se usa (el valor 0 o 1 no hace nada).
  • PermissionToBlockSender
  • PermissionToRequestRelease: no establezca este permiso y PermissionToRelease en el valor 1. Establezca un valor en 1 y el otro en 0 o establezca ambos valores en 0.
  • PermissionToRelease: no establezca este permiso y PermissionToRequestRelease en el valor 1. Establezca un valor en 1 y el otro en 0 o establezca ambos valores en 0. Este permiso no se respeta para los mensajes que se pusieron en cuarentena como malware o phishing de alta confianza. Si la directiva de cuarentena concede a los usuarios este permiso, se permite a los usuarios solicitar la liberación de su malware en cuarentena o mensajes de suplantación de identidad de alta confianza como si permissionToRequestRelease se seleccionara en su lugar.
  • PermissionToPreview
  • PermissionToDelete

Los valores de los grupos de permisos de usuario final preestablecidos se describen en la lista siguiente:

  • Sin acceso: Binary = 0000000, por lo que use el valor decimal 0.
  • Acceso limitado: Binario = 00011011, por lo que use el valor decimal 27.
  • Acceso completo: Binario = 00010111, por lo que use el valor decimal 23.

Para los permisos personalizados, obtenga el valor binario que corresponde a los permisos que desee. Convierta el valor binario en un valor decimal que se va a usar. No use el valor binario para este parámetro.

Nota: Si el valor de este parámetro es $true y el valor del parámetro EndUserQuarantinePermissionsValue es 0 (no hay acceso donde se desactivan todos los permisos), los usuarios pueden ver sus mensajes en cuarentena, pero la única acción disponible para los mensajes es Ver encabezado de mensaje.

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

EndUserSpamNotificationCustomFromAddress especifica la dirección de correo electrónico de un remitente interno existente que se usará como remitente para las notificaciones de cuarentena.

Si no usa este parámetro, el remitente predeterminado es 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

El parámetro EndUserSpamNotificationFrequency especifica la frecuencia con la que se envían las notificaciones de cuarentena a los usuarios. Los valores admitidos son:

  • 04:00:00 (4 horas)
  • 1.00:00:00 (1 día)
  • 7.00:00:00 (7 días)
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

Este parámetro está reservado para uso interno de 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

Este parámetro está reservado para uso interno de 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

El parámetro EsnCustomSubject especifica el texto que se va a usar en el campo Asunto de las notificaciones de cuarentena.

Puede especificar varios valores separados por comas mediante la sintaxis : ('value1',''value2',...'valueN'). Para cada idioma que especifique con el parámetro MultiLanguageSetting, debe especificar texto de remitente único. Asegúrese de alinear los valores de los parámetros MultiLanguageSetting, MultiLanguageCustomDisclaimer, EsnCustomSubject y MultiLanguageSenderName en el mismo orden.

Para modificar un valor existente y conservar otros valores, debe especificar todos los valores existentes y el nuevo valor en el orden existente.

Esta configuración solo está disponible en la directiva de cuarentena integrada denominada DefaultGlobalTag que controla la configuración de la directiva de cuarentena global. Para acceder a esta directiva de cuarentena, inicie el comando con la sintaxis siguiente: 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

El parámetro ESNEnabled especifica si se deben habilitar las notificaciones de cuarentena (anteriormente conocidas como notificaciones de correo no deseado del usuario final) para la directiva. Los valores admitidos son:

  • $true: las notificaciones de cuarentena están habilitadas.
  • $false: las notificaciones de cuarentena están deshabilitadas. El usuario solo puede acceder a los mensajes en cuarentena, no a las notificaciones por correo electrónico. Este es el valor predeterminado.

Nota: Si el valor de este parámetro es $true y el valor del parámetro EndUserQuarantinePermissionsValue es 0 (sin acceso donde se desactivan todos los permisos), los usuarios pueden ver sus mensajes en cuarentena, pero la única acción disponible para los mensajes es Ver encabezado de mensaje.

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

Este parámetro está reservado para uso interno de 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

Este parámetro está reservado para uso interno de 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

Este parámetro está reservado para uso interno de 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

El parámetro Name especifica un nombre único para la directiva de cuarentena. Si el valor contiene espacios, escriba el valor entre comillas (").

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

Este parámetro está reservado para uso interno de 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

Este parámetro está reservado para uso interno de 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

Este parámetro está reservado para uso interno de 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