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.

Sintaxis

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]
   [-IncludeMessagesFromBlockedSenderAddress <Boolean>]
   [-MultiLanguageCustomDisclaimer <MultiValuedProperty>]
   [-MultiLanguageSenderName <MultiValuedProperty>]
   [-MultiLanguageSetting <MultiValuedProperty>]
   [-OrganizationBrandingEnabled <Boolean>]
   [-QuarantineRetentionDays <Int32>]
   [-WhatIf]
   [<CommonParameters>]

Description

No se pueden modificar las directivas de cuarentena integradas denominadas AdminOnlyAccessPolicy, DefaultFullAccessPolicy o DefaultFullAccessWithNotificationPolicy.

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.

Tipo:Int32
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False
Se aplica a:Exchange Online, Exchange Online Protection

-AdminNotificationLanguage

Este parámetro está reservado para uso interno de Microsoft.

Tipo:EsnLanguage
Valores aceptados: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
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False
Se aplica a:Exchange Online, Exchange Online Protection

-AdminNotificationsEnabled

Este parámetro está reservado para uso interno de Microsoft.

Tipo:Boolean
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False
Se aplica a:Exchange Online, Exchange Online Protection

-AdminQuarantinePermissionsList

Este parámetro está reservado para uso interno de Microsoft.

Tipo:MultiValuedProperty
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False
Se aplica a: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, los 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 otros cmdlets (por ejemplo, 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.
Tipo:SwitchParameter
Alias:cf
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False
Se aplica a:Exchange Online, Exchange Online Protection

-CustomDisclaimer

Este parámetro está reservado para uso interno de Microsoft.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False
Se aplica a:Exchange Online, Exchange Online Protection

-DomainController

Este parámetro está reservado para uso interno de Microsoft.

Tipo:Fqdn
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False
Se aplica a:Exchange Online, Exchange Online Protection

-EndUserQuarantinePermissions

Nota: Para establecer permisos en las directivas de cuarentena, se recomienda usar el parámetro EndUserQuarantinePermissionsValue.

EndUserQuarantinePermissions especifica los permisos de usuario final para la directiva de cuarentena mediante una variable de la salida de un comando New-QuarantinePermissions o Set-QuarantinePermissions.

Por ejemplo, ejecute el siguiente comando para almacenar los permisos necesarios en una variable: $Perms = New-QuarantinePermissions <permissions>. En la misma sesión de PowerShell, use el valor $Perms de este parámetro.

Tipo:QuarantinePermissions
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False
Se aplica a: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
  • 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 = 00101011, por lo que use el valor decimal 43.
  • Acceso completo: Binario = 00100111, por lo que use el valor decimal 39.

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.

Tipo:Int32
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False
Se aplica a: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.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False
Se aplica a: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)
Tipo:TimeSpan
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False
Se aplica a:Exchange Online, Exchange Online Protection

-EndUserSpamNotificationFrequencyInDays

Este parámetro está reservado para uso interno de Microsoft.

Tipo:Int32
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False
Se aplica a:Exchange Online, Exchange Online Protection

-EndUserSpamNotificationLanguage

Este parámetro está reservado para uso interno de Microsoft.

Tipo:EsnLanguage
Valores aceptados: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
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False
Se aplica a: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 ....

Tipo:MultiValuedProperty
Alias:MultiValuedProperty
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False
Se aplica a: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.

Tipo:Boolean
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False
Se aplica a: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
Tipo:QuarantineTagIdParameter
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False
Se aplica a:Exchange Online, Exchange Online Protection

-IgnoreDehydratedFlag

Este parámetro está reservado para uso interno de Microsoft.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False
Se aplica a:Exchange Online, Exchange Online Protection

-IncludeMessagesFromBlockedSenderAddress

El parámetro IncludeMessagesFromBlockedSenderAddress especifica si se deben enviar notificaciones de cuarentena para los mensajes en cuarentena desde direcciones de remitente bloqueadas. Los valores admitidos son:

  • $true: los destinatarios reciben notificaciones de cuarentena para los mensajes afectados de remitentes bloqueados.
  • $false: los destinatarios no reciben notificaciones de cuarentena para los mensajes afectados de remitentes bloqueados. Este es el valor predeterminado.
Tipo:Boolean
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False
Se aplica a: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 un 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 ....

Tipo:MultiValuedProperty
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False
Se aplica a: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 ....

Tipo:MultiValuedProperty
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False
Se aplica a: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 ....

Nota: El valor Inglés se asigna a cada código en inglés excepto en-US. Si solo tiene usuarios con buzones en-US, use el valor Predeterminado. Si tiene una combinación de buzones con códigos en-US y otros idiomas del inglés (en-GB, en-CA, en-AU, etc.), use el valor Predeterminado en una notificación de cuarentena personalizada y el valor Inglés en otra notificación de cuarentena personalizada.

Tipo:MultiValuedProperty
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False
Se aplica a: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 ....

Tipo:Boolean
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False
Se aplica a:Exchange Online, Exchange Online Protection

-QuarantineRetentionDays

Este parámetro está reservado para uso interno de Microsoft.

Tipo:Int32
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False
Se aplica a: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.

Tipo:SwitchParameter
Alias:wi
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False
Se aplica a:Exchange Online, Exchange Online Protection