Compartir a través de

New-AIPCustomPermissions

  • Referencia
Módulo:
AzureInformationProtection

Relevante para: Solo cliente de etiquetado unificado de AIP

Crea una directiva de protección ad hoc para permisos personalizados.

Sintaxis

New-AIPCustomPermissions
   -Users <String[]>
   -Permissions <Permissions>
   [-ExpirationDate <DateTime>]
   [<CommonParameters>]

Description

El cmdlet New-AIPCustomPermissions crea un objeto de directiva de protección ad hoc para permisos personalizados que se almacenan como una variable y, a continuación, se usa para proteger un archivo o archivos al ejecutar el cmdlet de etiquetado Set-AIPFileLabel.

Si la etiqueta que se aplica está configurada para la configuración de protección, los permisos personalizados de la directiva de protección ad hoc reemplazan la configuración de protección de la etiqueta.

Ejemplos

Ejemplo 1: Creación de un objeto de directiva de protección ad hoc para un solo usuario

PS C:\> $permissions = New-AIPCustomPermissions -Users user1@contoso.com -Permissions Viewer

Este comando crea un objeto de directiva de protección ad hoc que concede a user1 de contoso.com derechos de uso de los permisos revisores y almacena esta directiva en una variable denominada permissions. Esta directiva de protección ad hoc se puede usar para aplicar la protección a un archivo o archivos.

No se muestra ninguna salida para este comando.

Ejemplo 2: Creación de un objeto de directiva de protección ad hoc para varios usuarios y que tiene una fecha de expiración

PS C:\> $permissions = New-AIPCustomPermissions -Users user1@contoso.com, user2@vanarsdel.com -Permissions Reviewer -ExpirationDate (Get-Date -Month 1 -Day 1 -Year 2020)

Este comando crea un objeto de directiva de protección ad hoc que concede a los usuarios de diferentes organizaciones derechos de uso de los permisos revisores y también aplica una fecha de expiración. El objeto de directiva de protección ad hoc se almacena en una variable denominada permissions, que se puede usar para aplicar esta protección a un archivo o archivos.

No se muestra ninguna salida para este comando.

Parámetros

-ExpirationDate

Especifica una fecha de expiración para la directiva de protección ad hoc.

Después de esta fecha de expiración, los usuarios especificados ya no podrán acceder al archivo o los archivos. Sin embargo, el propietario y un superusuario siempre pueden acceder al archivo, incluso después de alcanzar el período de expiración.

Tipo:DateTime
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Permissions

Especifica un nivel de permisos que agrupa los derechos de uso que normalmente se usan juntos. Use este parámetro y el parámetro Users para conceder derechos de uso a los usuarios especificados.

Para ver qué derechos de uso individuales se incluyen en cada uno de los niveles de permisos, consulte Derechos incluidos en los niveles de permisos.

Tipo:Permissions
Valores aceptados:Viewer, Reviewer, CoAuthor, CoOwner
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Users

Especifica los usuarios que tendrán derechos para usar el archivo o los archivos. Use este parámetro y el parámetro Permission para conceder derechos a usuarios o grupos especificados.

Tipo:String[]
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

Entradas

None

Salidas

System.Object