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 0En 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 |