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 1En 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:00En 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 |
Comentarios
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de