New-QuarantinePermissions

Módulo:

ExchangePowerShell

Se aplica a:

Exchange Online, Exchange Online Protection

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

Use el cmdlet New-QuarantinePermissions para crear objetos de permisos de cuarentena que se usarán con el cmdlet New-QuarantineTag.

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-QuarantinePermissions
   [-PermissionToBlockSender <Boolean>]
   [-PermissionToDelete <Boolean>]
   [-PermissionToDownload <Boolean>]
   [-PermissionToPreview <Boolean>]
   [-PermissionToRelease <Boolean>]
   [-PermissionToRequestRelease <Boolean>]
   [-PermissionToViewHeader <Boolean>]
   [<CommonParameters>]

Description

El valor predeterminado de los parámetros que no use es $false, por lo que solo debe usar los parámetros (permisos) que desea establecer en $true.

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

$NoAccess = New-QuarantinePermissions

En este ejemplo se crean los mismos permisos que usa el grupo Sin permisos de acceso en etiquetas de cuarentena en cumplimiento de seguridad & . El objeto permissions se almacena en la variable denominada $NoAccess.

En la misma sesión de Windows PowerShell, puede usar $NoAccess para el valor del parámetro EndUserQuarantinePermissions en un comando New-QuarantineTag o Set-QuarantineTag.

Ejemplo 2

$LimitedAccess = New-QuarantinePermissions -PermissionToBlockSender $true -PermissionToDelete $true -PermissionToPreview $true -PermissionToRequestRelease $true

En este ejemplo se crean los mismos permisos que usa el grupo Permisos de acceso limitado en etiquetas de cuarentena en cumplimiento de seguridad & . El objeto permissions se almacena en la variable denominada $LimitedAccess.

En la misma sesión de Windows PowerShell, puede usar $LimitedAccess para el valor del parámetro EndUserQuarantinePermissions en un comando New-QuarantineTag o Set-QuarantineTag.

Ejemplo 3

$FullAccess = New-QuarantinePermissions -PermissionToBlockSender $true -PermissionToDelete $true -PermissionToPreview $true -PermissionToRelease $true

En este ejemplo se crean los mismos permisos que usa el grupo Permisos de acceso completo en etiquetas de cuarentena en cumplimiento de seguridad & . El objeto permissions se almacena en la variable denominada $FullAccess.

En la misma sesión de Windows PowerShell, puede usar $FullAccess para el valor del parámetro EndUserQuarantinePermissions en un comando New-QuarantineTag o Set-QuarantineTag.

Parámetros

-PermissionToBlockSender

El parámetro PermissionToBlockSender especifica si los usuarios pueden agregar el remitente del mensaje en cuarentena a su lista de remitentes bloqueados. Los valores admitidos son:

• $true: el botón Bloquear remitente se incluye en las notificaciones de cuarentena del usuario final.
• $false: el botón Bloquear remitente no se incluye en las notificaciones de cuarentena del usuario final. Este es el valor predeterminado.

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-PermissionToDelete

El parámetro PermissionToDelete especifica si los usuarios pueden eliminar mensajes de la cuarentena. Los valores admitidos son:

• $true: el botón Quitar de la cuarentena se incluye en los detalles del mensaje en cuarentena.
• $false: el botón Quitar de la cuarentena no se incluye en los detalles del mensaje en cuarentena. Este es el valor predeterminado.

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-PermissionToDownload

El parámetro PermissionToDownload especifica si los usuarios pueden descargar mensajes de la cuarentena. Los valores admitidos son:

• $true: el permiso está habilitado.
• $false: el permiso está deshabilitado. Este es el valor predeterminado.

Actualmente, este valor no tiene ningún efecto en los botones que se incluyen en las notificaciones de correo no deseado del usuario final o en los detalles del mensaje en cuarentena.

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-PermissionToPreview

El parámetro PermissionToPreview especifica si los usuarios pueden obtener una vista previa de los mensajes en cuarentena. Los valores admitidos son:

• $true: el botón Vista previa del mensaje se incluye en los detalles del mensaje en cuarentena.
• $false: el botón Vista previa del mensaje no se incluye en los detalles del mensaje en cuarentena. Este es el valor predeterminado.

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-PermissionToRelease

El parámetro PermissionToRelease especifica si los usuarios pueden liberar directamente los mensajes de la cuarentena. Los valores admitidos son:

• $true: el botón Liberar se incluye en las notificaciones de correo no deseado del usuario final y el botón Liberar mensaje se incluye en los detalles del mensaje en cuarentena.
• $false: el botón Liberar no se incluye en las notificaciones de correo no deseado del usuario final y el botón Liberar mensaje no se incluye en los detalles del mensaje en cuarentena. Este es el valor predeterminado.

No establezca este parámetro y el parámetro PermissionToRequestRelease en $true. Establezca un parámetro en $true y el otro en $false, o establezca ambos parámetros en $false.

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-PermissionToRequestRelease

El parámetro PermissionToRequestRelease especifica si los usuarios pueden solicitar que los mensajes se liberen de la cuarentena. La solicitud debe ser aprobada por un administrador. Los valores válidos son:

• $true: el botón Liberar se incluye en las notificaciones de correo no deseado del usuario final y el botón Liberar mensaje se incluye en los detalles del mensaje en cuarentena.
• $false: el botón Liberar no se incluye en las notificaciones de correo no deseado del usuario final y el botón Liberar mensaje no se incluye en los detalles del mensaje en cuarentena. Este es el valor predeterminado.

No establezca este parámetro y el parámetro PermissionRelease en $true. Establezca un parámetro en $true y el otro en $false, o establezca ambos parámetros en $false.

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-PermissionToViewHeader

El parámetro PermissionToViewHeader especifica si los usuarios pueden ver los encabezados de mensaje de los mensajes en cuarentena. Los valores admitidos son:

• $true: el permiso está habilitado.
• $false: el permiso está deshabilitado. Este es el valor predeterminado.

Actualmente, este valor no tiene ningún efecto en los botones que se incluyen en las notificaciones de correo no deseado del usuario final o en los detalles del mensaje en cuarentena. El botón Ver encabezado del mensaje siempre está disponible en los detalles del mensaje en cuarentena.

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection