New-CustomPermissions

Référence

Module:: PurviewInformationProtection

Crée une stratégie de protection ad hoc pour les autorisations personnalisées.

Syntaxe

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

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éer 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 à user1de contoso.com des droits d’utilisation à partir des autorisations du réviseur et stocke cette stratégie dans une variable nommée autorisations. Cette stratégie de protection ad hoc peut ensuite être utilisée pour appliquer la protection à un ou plusieurs fichiers.

Aucune sortie n’est affichée pour cette commande.

Exemple 2 - Créer un objet de stratégie de protection ad hoc pour plusieurs utilisateurs et qui a 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. Toutefois, le propriétaire et un super utilisateur peuvent toujours accéder au fichier, même une fois la période d’expiration atteinte.

Type:	DateTime
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-Permissions

Spécifie un niveau d’autorisation qui regroupe les droits d’utilisation 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.

Type:	Permissions
Valeurs acceptées:	Viewer, Reviewer, CoAuthor, CoOwner
Position:	Named
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-Users

Spécifie les utilisateurs qui auront le droit d’utiliser le ou les fichiers. Utilisez ce paramètre et le paramètre Permission pour accorder des droits aux utilisateurs ou groupes spécifiés.

Type:	String[]
Position:	Named
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

Entrées

None

Sorties

System.Object

Partager via