New-QuarantinePermissions
Este cmdlet solo está disponible en el servicio basado en la nube.
Nota: En lugar de usar este cmdlet para establecer permisos de directiva de cuarentena, se recomienda usar el parámetro EndUserQuarantinePermissionsValue en los cmdlets New-QuarantinePolicy y Set-QuarantinePolicy.
Use el cmdlet New-QuarantinePermissions para crear una variable que contenga un objeto de permisos de cuarentena que se usará con el parámetro EndUserQuarantinePermission en los cmdlets New-QuarantinePolicy o Set-QuarantinePolicy en la misma sesión de 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.
Sintaxis
New-QuarantinePermissions
[[-PermissionToAllowSender] <Boolean>]
[[-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 las directivas de cuarentena. El objeto permissions se almacena en la variable denominada $NoAccess
.
En la misma sesión de PowerShell, puede usar $NoAccess
para el valor del parámetro EndUserQuarantinePermissions en un comando New-QuarantinePolicy o Set-QuarantinePolicy.
Ejemplo 2
$LimitedAccess = New-QuarantinePermissions -PermissionToAllowSender $true -PermissionToDelete $true -PermissionToPreview $true -PermissionToRequestRelease $true
En este ejemplo se crean los mismos permisos que usa el grupo Permisos de acceso limitado en las directivas de cuarentena. El objeto permissions se almacena en la variable denominada $LimitedAccess
.
En la misma sesión de PowerShell, puede usar $LimitedAccess
para el valor del parámetro EndUserQuarantinePermissions en un comando New-QuarantinePolicy o Set-QuarantinePolicy.
Ejemplo 3
$FullAccess = New-QuarantinePermissions -PermissionToAllowSender $true -PermissionToDelete $true -PermissionToPreview $true -PermissionToRelease $true
En este ejemplo se crean los mismos permisos que usa el grupo Permisos de acceso completo en las directivas de cuarentena. El objeto permissions se almacena en la variable denominada $FullAccess
.
En la misma sesión de PowerShell, puede usar $FullAccess
para el valor del parámetro EndUserQuarantinePermissions en un comando New-QuarantinePolicy o Set-QuarantinePolicy.
Parámetros
-PermissionToAllowSender
El parámetro PermissionToAllowSender especifica si los usuarios pueden agregar el remitente del mensaje en cuarentena a su lista de remitentes seguros. Los valores admitidos son:
- $true: Permitir remitente está disponible para los mensajes afectados en cuarentena.
- $false: Permitir remitente no está disponible para los mensajes afectados en cuarentena. Este es el valor predeterminado.
Tipo: | Boolean |
Posición: | 1 |
Valor predeterminado: | False |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
Se aplica a: | Exchange Online, Exchange Online Protection |
-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: Bloquear remitente está disponible en las notificaciones de cuarentena para los mensajes afectados y Bloquear remitente está disponible para los mensajes afectados en cuarentena.
- $false: Bloquear remitente no está disponible en las notificaciones de cuarentena para los mensajes afectados y Bloquear remitente no está disponible para los mensajes afectados en cuarentena. Este es el valor predeterminado.
Tipo: | Boolean |
Posición: | 2 |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
Se aplica a: | 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: Eliminar mensajes y Eliminar de la cuarentena están disponibles para los mensajes afectados en cuarentena.
- $false: Eliminar mensajes y Eliminar de la cuarentena no están disponibles para los mensajes afectados en cuarentena. Este es el valor predeterminado.
Tipo: | Boolean |
Posición: | 3 |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
Se aplica a: | 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 las acciones disponibles en las notificaciones de cuarentena o en la cuarentena de los mensajes afectados. Los usuarios finales no pueden descargar mensajes en cuarentena.
Tipo: | Boolean |
Posición: | 4 |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
Se aplica a: | 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 mensaje de vista previa está disponible para los mensajes afectados en cuarentena.
- $false: el mensaje de vista previa no está disponible para los mensajes afectados en cuarentena. Este es el valor predeterminado.
Tipo: | Boolean |
Posición: | 5 |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
Se aplica a: | Exchange Online, Exchange Online Protection |
-PermissionToRelease
El parámetro PermissionToRelease especifica si los usuarios pueden liberar directamente los mensajes afectados de la cuarentena. Los valores admitidos son:
- $true: La versión está disponible en las notificaciones de cuarentena para los mensajes afectados y la versión (correo electrónico de liberación) está disponible para los mensajes afectados en cuarentena.
- $false: el mensaje de versión no está disponible en las notificaciones de cuarentena para los mensajes afectados y el correo electrónico de versión y versión no está disponible para los mensajes afectados en cuarentena.
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.
Tipo: | Boolean |
Posición: | 6 |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
Se aplica a: | 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: La versión de solicitud está disponible en las notificaciones de cuarentena para los mensajes afectados y la versión de solicitud está disponible para los mensajes afectados en cuarentena.
- $false: La versión de solicitud no está disponible en las notificaciones de cuarentena para los mensajes afectados y la versión de solicitud no está disponible para los mensajes afectados en cuarentena.
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.
Tipo: | Boolean |
Posición: | 7 |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
Se aplica a: | 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 las acciones disponibles en las notificaciones de cuarentena o en la cuarentena de los mensajes afectados. El encabezado del mensaje de visualización siempre está disponible para los mensajes afectados en cuarentena.
Tipo: | Boolean |
Posición: | 8 |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
Se aplica a: | Exchange Online, Exchange Online Protection |