Compartir a través de


Set-QuarantinePolicy

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

Use el cmdlet Set-QuarantinePolicy para modificar las 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

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

No puede modificar las directivas de cuarentena integradas denominadas AdminOnlyAccessPolicy o DefaultFullAccessPolicy.

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

Set-QuarantinePolicy -Identity CustomAccess -EndUserQuarantinePermissionsValue 1

En este ejemplo se configuran los permisos de la directiva de cuarentena denominada CustomAccess que permite a los usuarios eliminar solo los mensajes en cuarentena.

Ejemplo 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

En este ejemplo se modifica la configuración global de las notificaciones de cuarentena (anteriormente conocida como configuración de notificación de correo no deseado del usuario final):

  • Las notificaciones de cuarentena se personalizan para inglés, chino y francés. Las comillas adicionales son necesarias en el valor francés MultiLanguageCustomDisclaimer como caracteres de escape para los caracteres de comillas del texto.
  • El usuario aashutosh@contso.onmicrosoft.com existente se usa como remitente de la notificación de cuarentena.
  • El logotipo personalizado configurado anteriormente reemplaza al logotipo predeterminado de Microsoft.
  • La frecuencia de las notificaciones de cuarentena se cambia a 4 horas.

Parámetros

-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

-Confirm

El modificador Confirm especifica si se debe mostrar u ocultar el mensaje de confirmación. Cómo afecta este modificador el cmdlet depende de si el cmdlet requiere confirmación antes de continuar.

  • Los cmdlets destructivos (por ejemplo, cmdlets Remove-*) tienen una pausa integrada que obliga a confirmar el comando antes de continuar. En estos cmdlets, el mensaje de confirmación se puede omitir mediante esta sintaxis exacta: -Confirm:$false.
  • La mayoría de los demás cmdlets (por ejemplo, los cmdlets New-* y Set-*) no tienen una pausa integrada. En estos cmdlets, si se especifica el modificador Confirm sin ningún valor, se introduce una pausa que obliga a confirmar el 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

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 0 (Sin acceso) y el valor del parámetro ESNEnabled es $true, 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. Para volver a establecer este parámetro en la dirección quarantine@messaging.microsoft.comde correo electrónico predeterminada, use el 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

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 (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:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-Identity

El parámetro Identity especifica la directiva de cuarentena que desea modificar. Puede usar cualquier valor que identifique de forma única la directiva de cuarentena. Por ejemplo:

  • Nombre
  • Nombre completo (DN)
  • 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

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

El parámetro MultiLanguageCustomDisclaimer especifica el texto de declinación de responsabilidad personalizado que se usará cerca de la parte inferior de las notificaciones de cuarentena. El texto localizado, una declinación de responsabilidades de su organización: siempre se incluye primero, seguido del texto que especifique para este parámetro.

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 declinación de responsabilidades personalizado ú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:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-MultiLanguageSenderName

El parámetro MultiLanguageSenderName especifica el nombre para mostrar del remitente del correo electrónico que se usará en 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, puede especificar un nombre de remitente único. Asegúrese de alinear los valores de los parámetros MultiLanguageSetting, MultiLanguageCustomDisclaimer y MultiLanguageSenderName correspondientes 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 global. Para acceder a esta directiva de cuarentena, inicie el comando con la sintaxis siguiente: 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

El parámetro MultiLanguageSetting especifica el idioma de las notificaciones de cuarentena. Los valores admitidos son:

Default, Amharic, Arabic, Basque, BengaliIndia, Bulgaria, Catalan, ChineseSimplified, ChineseTraditional, Croatian, Cirílico, checo, danés, holandés, inglés, estonio, filipino, finés, francés, gallego, alemán, griego, gujarati, hebreo, hindi, húngaro, islandés, indonesio, italiano, japonés, kannada, kazajo, coreano, letón, lituano, malayo, malayalam, marathi, noruego, noruegoNynorsk, odia, persa, polaco, portugués, portuguésportugal, rumano, ruso, serbio, serbiocyrillic, Eslovaco, esloveno, español, swahili, sueco, tamil, telugu, tailandés, turco, ucraniano, urdu y vietnamita.

Puede especificar varios valores separados por comas mediante la sintaxis : ('value1',''value2',...'valueN'). El valor predeterminado es Predeterminado, lo que significa que las notificaciones de cuarentena usan el idioma predeterminado de la organización basada en la nube.

Para cada idioma que especifique, puede especificar un valor único para los parámetros MultiLanguageCustomDisclaimer y MultiLanguageSenderName. Asegúrese de alinear los valores de los parámetros MultiLanguageSetting, MultiLanguageCustomDisclaimer y MultiLanguageSenderName correspondientes en el mismo orden.

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

El parámetro OrganizationBrandingEnabled habilita o deshabilita la personalización de marca de la organización en los mensajes de notificación de cuarentena del usuario final. Los valores admitidos son:

  • $true: La personalización de marca de la organización está habilitada. El logotipo de Microsoft predeterminado que se usa en las notificaciones de cuarentena se reemplaza por el logotipo personalizado. Antes de hacerlo, debe seguir las instrucciones de Personalización del tema de Microsoft 365 para que su organización cargue el logotipo personalizado.
  • $false: la personalización de marca de la organización está deshabilitada. El logotipo predeterminado de Microsoft se usa en las notificaciones de cuarentena. Este es el valor predeterminado.

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

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

-WhatIf

El modificador WhatIf simula las acciones del comando. Puede usar este modificador para ver los cambios que se producirían, pero sin aplicar los cambios. No es necesario especificar un valor con este modificador.

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