Set-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 Set-QuarantinePermissions para modificar los objetos de permisos de cuarentena que se usan en etiquetas de cuarentena (los cmdlets New-QuarantineTag o Set-QuarantineTag). Este cmdlet solo funciona en objetos de permisos creados por el cmdlet New-QuarantinePermissions y almacenados en una variable que está disponible actualmente en la sesión de Windows PowerShell.

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

Description

Para ver el valor actual del objeto de permisos que desea modificar, ejecute el nombre de la variable como comando. Por ejemplo, ejecute el comando $Perms para ver los permisos de etiqueta de cuarentena almacenados en la $Perms variable.

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-QuarantinePermissions -QuarantinePermissionsObject $Perms -PermissionToRequestRelease $true -PermissionToRelease $false

En este ejemplo se modifican los permisos de etiqueta de cuarentena especificados en el objeto de permisos de salida $Perms que se creó anteriormente en la misma sesión de Windows PowerShell (la $Perms variable sigue estando disponible y rellenada).

En la misma sesión de Windows PowerShell, puede usar $Perms 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

-QuarantinePermissionsObject

El parámetro QuarantinePermissionsObject especifica la variable que contiene el objeto de permisos de cuarentena que desea modificar. Por ejemplo, si ejecutó el comando $Perms = New-QuarantinePermissions <permissions>, use el valor $Perms de este parámetro.

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