Add-AadrmTemplate

Référence

Module:: AADRM

Crée un modèle Rights Management.

Syntax

Add-AadrmTemplate
   -Names <Hashtable>
   -Descriptions <Hashtable>
   [-RightsDefinitions <System.Collections.Generic.List`1[Microsoft.RightsManagementServices.Online.Admin.TemplateRightsDefinition]>]
   [-ContentExpirationOption <ContentExpirationType>]
   [-ContentExpirationDate <DateTime>]
   [-ContentValidityDuration <Int32>]
   [-LicenseValidityDuration <Int32>]
   [-Status <TemplateStatus>]
   [-ScopedIdentities <System.Collections.Generic.List`1[System.String]>]
   [-EnableInLegacyApps <Boolean>]
   [<CommonParameters>]

Description

Notes

Cette applet de commande du module AADRM est désormais déconseillée. Après le 15 juillet 2020, ce nom d’applet de commande ne sera pris en charge qu’en tant qu’alias pour son remplacement dans le module AIPService.

Pour plus d’informations, consultez la page de présentation.

L’applet de commande Add-AadrmTemplate crée un modèle personnalisé Azure Rights Management avec le nom, la description et la stratégie spécifiés, et définit l’état du modèle à archiver ou à publier.

Les mêmes actions de configuration peuvent également être effectuées dans le Portail Azure.

Important : avant d’utiliser cette applet de commande, vous devez d’abord créer un objet de définition de droits qui spécifie les droits que vous souhaitez accorder et à qui, à l’aide de l’applet de commande New-AadrmRightsDefinition .

Vous pouvez stocker au maximum 500 modèles personnalisés (publiés ou archivés) dans Azure. Si vous ne pouvez pas ajouter de nouveaux modèles, car vous avez atteint cette limite en raison de la conservation de nombreux modèles archivés, envisagez de les exporter pour enregistrer les informations localement, puis de supprimer ces modèles dans Azure.

Pour plus d’informations sur les modèles personnalisés, notamment sur la façon de les configurer dans le Portail Azure, consultez Configuration et gestion des modèles pour Azure Information Protection sur le site de documentation Microsoft.

Exemples

Exemple 1 : Créer un modèle de service pour le contenu confidentiel

PS C:\> $names = @{}
PS C:\> $names[1033] = "New Launch - Confidential content"
PS C:\> $names[1034] = " Nuevo Lanzamiento - Contenido confidencial"
PS C:\> $descriptions = @{}
PS C:\> $descriptions[1033] = "This content is confidential for people working on the New Launch project and should not be shared externally"
PS C:\> $descriptions[1034] = "Este contenido es confidencial para empleados trabajando en el proyecto Nuevo Lanzamiento y no debe ser compartido fuera de la organización"
PS C:\> $r1 = New-AadrmRightsDefinition -EmailAddress marketing@contoso.com -Rights "VIEW","EXPORT"
PS C:\> $r2 = New-AadrmRightsDefinition -EmailAddress engineering@contoso.com -Rights "VIEW","DOCEDIT"
PS C:\> Add-AadrmTemplate -Names $names -Descriptions $Descriptions -LicenseValidityDuration 5 -RightsDefinitions $r1, $r2 -ScopedIdentities engineering@contoso.com -Status Published

Cet exemple crée un modèle départemental pour des ingénieurs quand ils travaillent sur le projet New Launch. Le modèle est nommé New Launch - Contenu confidentiel et a des noms et des descriptions en anglais et en espagnol. Il accorde des droits d’affichage et d’exportation au service marketing (permet d’afficher et d’enregistrer dans un fichier non protégé) à l’aide du marketing@contoso.com groupe, ainsi que des droits Afficher et DocEdit (permet d’afficher et de modifier le contenu, mais pas d’enregistrer les modifications) au service d’ingénierie à l’aide du engineering@contoso.com groupe.

Paramètres

-ContentExpirationDate

Spécifie la date à laquelle le contenu protégé avec le modèle expire.

Utilisez ce paramètre uniquement si le paramètre ContentExpirationOption est défini sur OnDate.

Type:	DateTime
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ContentExpirationOption

Spécifie le type d'expiration pour le contenu protégé avec le modèle.

Les valeurs valides pour ce paramètre sont :

Jamais. Indique que le contenu est disponible indéfiniment.
OnDate. Indique que le contenu expire à une date précise.
AfterDays. Indique que le contenu est disponible pendant le nombre de jours spécifié après l'application de la protection.

Type:	ContentExpirationType
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ContentValidityDuration

Indique le nombre de jours (à partir du premier jour où la protection est appliquée) après lequel le contenu protégé avec le modèle expire.

Utilisez ce paramètre uniquement si le paramètre ContentExpirationOption est défini sur AfterDays.

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Descriptions

Spécifie une liste de descriptions pour le modèle.

Créez des noms et des descriptions pour plusieurs ID régionaux à l’aide de la syntaxe de table de hachage dans Windows PowerShell. Au moins une paire nom-description doit exister. Les ID des paramètres régionaux pour les noms et les descriptions doivent correspondre. Si un ID de paramètres régionaux est spécifié, sa valeur doit contenir une chaîne non vide.

$descriptions = @{}

$descriptions[1033] = « Ce contenu est confidentiel et ne doit pas être partagé en externe »

$descriptions[1034] = « Este contenido es confidencial y no debe ser compartido fuera de la organización »

Type:	Hashtable
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-EnableInLegacyApps

Détermine le comportement d’un modèle départemental dans les applications qui ne prennent pas en charge les modèles de service (voir le paramètre ScopedIdentities ).

Si la valeur True est définie sur True et que le modèle est un modèle de service, tous les utilisateurs qui tentent de protéger le contenu d’une application qui ne prend pas en charge les modèles de service voient le modèle et peuvent donc le sélectionner, que les utilisateurs soient membres de l’étendue cible du modèle ou non.

Si la valeur est False, aucun utilisateur ne voit et ne peut donc pas sélectionner le modèle dans les applications qui ne prennent pas en charge les modèles de service, même si les utilisateurs sont membres de l’étendue cible du modèle.

Ce paramètre n'a aucun effet sur les modèles autres que les modèles de service, ni sur les applications qui prennent en charge les modèles de service en mode natif.

Remarque : ce paramètre est fonctionnellement l’équivalent du modèle Afficher ce modèle à tous les utilisateurs lorsque les applications ne prennent pas en charge la case à cocher identité utilisateur si vous avez configuré LA COMPATIBILITÉ DES APPLICATIONS dans le portail Azure Classic. Le portail classic est maintenant mis hors service et il n’existe aucun paramètre équivalent dans le Portail Azure.

Le client Azure Information Protection prend en charge les modèles départementaux, tandis qu’Exchange Outlook Web Access et Exchange ActiveSync sont des exemples d’applications qui ne prennent pas en charge actuellement les modèles de service. Pour ces applications Exchange (et toutes les autres applications qui ne prennent pas en charge les modèles de service), vous devez décider si tous les utilisateurs peuvent sélectionner un modèle de service dans la liste des modèles disponibles ou si aucun utilisateur ne peut sélectionner un modèle de service dans la liste.

Ce paramètre ne détermine pas si un utilisateur peut accéder au contenu protégé par un modèle de service ; il affecte uniquement sa capacité à sélectionner le modèle proprement dit.

Si vous avez des applications qui ne prennent pas en charge les modèles de service par défaut, vous pouvez utiliser un script de téléchargement de modèle RMS personnalisé ou d’autres outils pour déployer ces modèles dans le dossier client RMS local. Ensuite, ces applications affichent correctement les modèles de service.

À partir d'un ordinateur client ayant téléchargé tous les modèles, vous pouvez copier et coller les fichiers de modèle sur d'autres ordinateurs.

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-LicenseValidityDuration

Spécifie la période de validité des licences d'utilisation pour le contenu protégé avec ce modèle.

La valeur est spécifiée comme le nombre de jours pendant lesquels le contenu est disponible en mode hors connexion après qu'une licence d'utilisation est acquise (0-9999). Les utilisateurs peuvent rouvrir contenu auquel ils ont déjà accédé sans avoir besoin d'une connexion au réseau Internet pendant cette période.

La réduction de cette valeur donne plus de contrôle aux propriétaires de documents en permettant de garantir que le contenu qui a été révoqué ou pour lequel la politique a changé n'est plus accessible pendant un temps après ces modifications.

L'augmentation de cette valeur donne plus de liberté aux utilisateurs afin d'accéder au contenu sans avoir besoin d'une connexion au réseau Internet.

Pour spécifier un accès illimité, utilisez -1. Pour spécifier qu’une licence d’utilisation doit être obtenue chaque fois que le contenu protégé est accessible et que le contenu est disponible uniquement avec une connexion Internet, spécifiez 0.

Chaque organisation dispose d’une durée maximale de validité de la licence, qui est de 30 jours par défaut et peut être configurée à l’aide de Set-AadrmMaxUseLicenseValidityTime. La valeur que vous spécifiez pour le paramètre LicenseValidityDuration doit être inférieure à cette valeur.

Lorsqu’il existe des valeurs différentes pour l’heure de validité de la licence d’utilisation, par exemple, une valeur pour le locataire et une pour le modèle, Azure RMS utilise la valeur la plus restrictive.

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Names

Spécifie une liste de noms pour le modèle.

N’incluez aucun des caractères suivants dans le nom, car tous les services et applications qui utilisent Azure Information Protection peuvent prendre en charge ces caractères :< > % & / ? ; + \ : #

Créez des noms et des descriptions pour plusieurs ID régionaux à l’aide de la syntaxe de table de hachage dans Windows PowerShell. Il doit y avoir au moins une paire nom/description. Les ID régionaux pour les noms et les descriptions doivent correspondre les uns aux autres. Si un ID de paramètres régionaux est spécifié, sa valeur doit contenir une chaîne non vide.

$names = @{}

$names[1033] = « Contenu confidentiel »

$names[1034] = « Contenido confidencial »

Type:	Hashtable
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-RightsDefinitions

Spécifie une liste d’objets de définition de droits spécifiés à l’aide de l’applet de commande New-AadrmRightsDefinition .

Ces objets de définition de droits expriment les droits d’accorder des utilisateurs ou des groupes individuels au contenu protégé par l’application du modèle.

Les objets de définition de droits contiennent l’adresse e-mail de l’identité et les droits à lui attribuer.

Type:	System.Collections.Generic.List`1[Microsoft.RightsManagementServices.Online.Admin.TemplateRightsDefinition]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ScopedIdentities

Répertorie, par adresse de messagerie (compte ou groupe), les utilisateurs qui peuvent voir et donc sélectionner les modèles de service à partir d'applications.

Pour que les utilisateurs spécifiés voient les modèles, l’application doit prendre en charge les modèles de service ou le paramètre EnableInLegacyApps doit être défini sur True.

Type:	System.Collections.Generic.List`1[System.String]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Status

Spécifie l'état du modèle.

Les valeurs autorisées sont archivées et publiées.

Des modèles archivés sont disponibles pour utiliser du contenu auparavant protégé, mais ne sont pas visibles aux utilisateurs.
Les modèles publiés sont distribués aux utilisateurs et mis à disposition pour protéger du contenu.

Type:	TemplateStatus
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Entrées

System.String[],System.String[],System.String[],System.string,System.DateTime,System.int,System.int

-Noms $Names ; Un ou plusieurs noms pour le modèle, dans différentes langues, à présenter aux utilisateurs en fonction de leurs paramètres régionaux système.

[-Descriptions $Descriptions] ; Une ou plusieurs descriptions du modèle, dans différentes langues pour présenter aux utilisateurs en fonction de leurs paramètres régionaux système.

[-RightsDefinitions {$r 1,$r 2,...}] ; Liste des définitions de droits sous la forme d’objets Rights Definition .

[-ContentExpirationOption ContentExpirationType.Never| OnDate| AfterDays] ; Type d’expiration de contenu pour le contenu protégé avec le modèle.

[-ContentExpirationDate DateTime] ; Date ou heure à laquelle le contenu expire, si ContentExpirationOption est défini sur OnDate.

[-ContentValidityDuration int] ; Nombre de jours pour lesquels le contenu est disponible après sa protection si ContentExpirationOption est défini sur AfterDays.

[-LicenseValidityDuration int] ; Nombre de jours pour lesquels le contenu est disponible en ligne jusqu’à son expiration (0-9999). Pour spécifier un accès illimité, utilisez -1. Pour spécifier qu’une licence doit être obtenue pour chaque utilisation et que le contenu est disponible uniquement en ligne, utilisez 0.

[-Status TemplateStatus.Archived| Publié] ; État du modèle. Des modèles archivés sont disponibles pour utiliser du contenu auparavant protégé, mais ne sont pas présentés aux utilisateurs. Les modèles publiés sont distribués aux utilisateurs et mis à disposition pour protéger du contenu.