New-CustomPermissions
Crée une stratégie de protection ad hoc pour les autorisations personnalisées.
Syntaxe
Default (Par défaut)
New-CustomPermissions
-Users <String[]>
-Permissions <Permissions>
[-ExpirationDate <DateTime>]
Description
L’applet de commande New-CustomPermissions crée un objet de stratégie de protection ad hoc pour les autorisations personnalisées que vous stockez en tant que variable, puis que vous utilisez pour protéger un ou plusieurs fichiers lorsque vous exécutez l’applet de commande d’étiquetage, Set-FileLabel.
Si l’étiquette appliquée est configurée pour les paramètres de protection, les autorisations personnalisées de la stratégie de protection ad hoc remplacent les paramètres de protection de l’étiquette.
Exemples
Exemple 1 : création d’un objet de stratégie de protection ad hoc pour un seul utilisateur
PS C:\> $permissions = New-CustomPermissions -Users user1@contoso.com -Permissions Viewer
Cette commande crée un objet de stratégie de protection ad hoc qui accorde à user1 à partir de contoso.com droits d’utilisation à partir des autorisations Reviewer et stocke cette stratégie dans une variable nommée permissions. Cette politique de protection ad hoc peut ensuite être utilisée pour appliquer une protection à un ou plusieurs fichiers.
Aucune sortie n’est affichée pour cette commande.
Exemple 2 : création d’un objet de stratégie de protection ad hoc pour plusieurs utilisateurs et doté d’une date d’expiration
PS C:\> $permissions = New-CustomPermissions -Users user1@contoso.com, user2@vanarsdel.com -Permissions Reviewer -ExpirationDate (Get-Date -Month 1 -Day 1 -Year 2020)
Cette commande crée un objet de stratégie de protection ad hoc qui accorde aux utilisateurs de différentes organisations des droits d’utilisation à partir des autorisations Réviseur, et applique également une date d’expiration. L’objet de stratégie de protection ad hoc est stocké dans une variable nommée permissions, qui peut ensuite être utilisée pour appliquer cette protection à un ou plusieurs fichiers.
Aucune sortie n’est affichée pour cette commande.
Paramètres
-ExpirationDate
Spécifie une date d’expiration pour la stratégie de protection ad hoc.
Après cette date d’expiration, les utilisateurs spécifiés ne pourront plus accéder au ou aux fichiers. Cependant, le propriétaire et un super-utilisateur peuvent toujours accéder au fichier, même après que la période d’expiration est atteinte.
Propriétés du paramètre
| Type: | DateTime |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Permissions
Spécifie un niveau d’autorisation qui regroupe les droits d’utilisation qui sont généralement utilisés ensemble. Utilisez ce paramètre et le paramètre Users pour accorder des droits d’utilisation aux utilisateurs spécifiés.
Pour voir quels droits d’utilisation individuels sont inclus dans chacun des niveaux d’autorisation, consultez Droits inclus dans les niveaux d’autorisation.
Propriétés du paramètre
| Type: | Permissions |
| Valeur par défaut: | None |
| Valeurs acceptées: | Viewer, Reviewer, CoAuthor, CoOwner |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | True |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Users
Spécifie les utilisateurs qui auront les droits d’utilisation du ou des fichiers. Utilisez ce paramètre et le paramètre Permission pour accorder des droits à des utilisateurs ou à des groupes spécifiés.
Propriétés du paramètre
| Type: | String[] |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | True |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |