New-CustomPermissions
Crea una política de protección ad-hoc para permisos personalizados.
Sintaxis
Default (valor predeterminado)
New-CustomPermissions
-Users <String[]>
-Permissions <Permissions>
[-ExpirationDate <DateTime>]
Description
El cmdlet New-CustomPermissions crea un objeto de directiva de protección ad hoc para los permisos personalizados que se almacena como una variable y, a continuación, se usa para proteger uno o varios archivos al ejecutar el cmdlet de etiquetado, Set-FileLabel.
Si la etiqueta que se aplica está configurada para la configuración de protección, los permisos personalizados de la política 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-CustomPermissions -Users user1@contoso.com -Permissions Viewer
Este comando crea un objeto de política de protección ad hoc que concede al usuario1 derechos de uso de contoso.com de los permisos de Reviewer y almacena esta política en una variable denominada permissions. Esta política de protección ad-hoc se puede utilizar para aplicar 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 tenga una fecha de caducidad
PS C:\> $permissions = New-CustomPermissions -Users user1@contoso.com, user2@vanarsdel.com -Permissions Reviewer -ExpirationDate (Get-Date -Month 1 -Day 1 -Year 2020)
Este comando crea un objeto de política de protección ad hoc que concede a los usuarios de diferentes organizaciones derechos de uso de los permisos de Reviewer y también aplica una fecha de caducidad. El objeto de política 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 caducidad, los usuarios especificados ya no podrán acceder al archivo o archivos. Sin embargo, el propietario y un superusuario siempre pueden acceder al archivo, incluso después de que se alcance el período de caducidad.
Propiedades de parámetro
| Tipo: | DateTime |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-Permissions
Especifica un nivel de permisos que agrupa los derechos de uso que normalmente se utilizan juntos. Utilice 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.
Propiedades de parámetro
| Tipo: | Permissions |
| Valor predeterminado: | None |
| Valores aceptados: | Viewer, Reviewer, CoAuthor, CoOwner |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | True |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-Users
Especifica los usuarios que tendrán derechos para usar el archivo o los archivos. Utilice este parámetro y el parámetro Permission para conceder derechos a usuarios o grupos especificados.
Propiedades de parámetro
| Tipo: | String[] |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | True |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |