New-AIPCustomPermissions

Référence

Module:: AzureInformationProtection

Pertinent pour : Client d’étiquetage unifié AIP uniquement

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

Syntax

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

Description

L’applet de commande New-AIPCustomPermissions crée un objet de stratégie de protection ad hoc pour les autorisations personnalisées que vous stockez en tant que variable, puis pour protéger un fichier ou des fichiers lorsque vous exécutez l’applet de commande d’étiquetage Set-AIPFileLabel.

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-AIPCustomPermissions -Users user1@contoso.com -Permissions Viewer

Cette commande crée un objet de stratégie de protection ad hoc qui accorde à l’utilisateur1 des droits d’utilisation de contoso.com des autorisations de 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 fichier ou à des 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-AIPCustomPermissions -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 des autorisations de 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 autorisations, qui peuvent ensuite être utilisées pour appliquer cette protection à un fichier ou à des 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 fichier 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
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Permissions

Spécifie un niveau d’autorisations 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’autorisations, consultez Droits inclus dans les niveaux d’autorisation.

Type:	Permissions
Accepted values:	Viewer, Reviewer, CoAuthor, CoOwner
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Users

Spécifie les utilisateurs qui auront le droit d’utiliser le fichier 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
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

Entrées

None

Sorties

System.Object

Set-AIPFileLabel