Get-AadrmTemplateProperty
Obtient les propriétés d’un modèle Rights Management.
Syntax
Get-AadrmTemplateProperty
-TemplateId <Guid>
[-Names]
[-Descriptions]
[-RightsDefinitions]
[-ContentExpirationOption]
[-ContentExpirationDate]
[-ContentValidityDuration]
[-LicenseValidityDuration]
[-ReadOnly]
[-Status]
[-ScopedIdentities]
[-EnableInLegacyApps]
[<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 Get-AadrmTemplateProperty obtient les propriétés spécifiées d’un modèle Azure Rights Management, à l’aide du paramètre TemplateId.
Des informations de configuration similaires peuvent également être consultées dans le Portail Azure, mais cette applet de commande inclut également le GUID du modèle.
Vous pouvez interroger les propriétés d’un modèle par défaut ou d’un modèle personnalisé. Pour plus d’informations sur les modèles personnalisés, notamment comment les configurer dans le Portail Azure, consultez Configuration et gestion des modèles pour Azure Information Protection.
Exemples
Exemple 1 : Obtenir la description et les droits d’utilisation d’un modèle
PS C:\>Get-AadrmTemplateProperty -TemplateId 28168524-29c3-44f1-9e11-ea6c60bb6428 -Descriptions -RightsDefinitions
Cette commande obtient la description et les droits d’utilisation pour tous les utilisateurs ou groupes configurés pour le modèle Rights Management spécifié.
Exemple 2 : Pour tous les modèles, obtenez le nom, les droits d’utilisation, qu’il s’agisse d’un modèle par défaut ou d’un modèle publié ou archivé
PS C:\>$templates = Get-AadrmTemplate PS C:\>foreach ($template in $templates) {Get-AadrmTemplateProperty -TemplateId $template.TemplateId -Name -RightsDefinitions -ReadOnly -Status}
La première commande obtient tous les ID de modèle et les stocke dans une variable. La deuxième commande utilise ensuite cette variable pour obtenir le nom du modèle, les droits d’utilisation, qu’il soit en lecture seule (True pour un modèle par défaut, False pour un modèle personnalisé) et l’état (Publié ou archivé) pour chaque modèle.
Paramètres
-ContentExpirationDate
Répertorie la date à laquelle le contenu protégé avec le modèle expire.
Utilisez ce paramètre uniquement si ContentExpirationOption est défini sur OnDate.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ContentExpirationOption
Obtient le paramètre de configuration d’expiration de contenu pour le contenu protégé par le modèle.
Une des valeurs suivantes est retournée :
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: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ContentValidityDuration
Répertorie le nombre de jours de la journée de protection après laquelle le contenu protégé avec le modèle expire.
Utilisez ce paramètre uniquement si ContentExpirationOption est défini sur AfterDays.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Descriptions
Répertorie les descriptions du modèle dans tous les paramètres régionaux.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-EnableInLegacyApps
Indique le comportement d’un modèle de service 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.
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é de l’utilisateur lorsque vous configurez LA COMPATIBILITÉ DES APPLICATIONS dans le portail Azure Classic.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-LicenseValidityDuration
Répertorie le nombre de jours de contenu accessible hors connexion après l’acquisition d’une licence.
-1 indique un accès illimité.
0 indique qu'une licence doit être obtenue pour chaque utilisation et que le contenu est uniquement disponible en ligne.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Names
Répertorie les noms du modèle dans tous les paramètres régionaux.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ReadOnly
Indique si le modèle est un modèle par défaut (True) et ne peut donc pas être modifié ou supprimé, ou un modèle personnalisé (False) et peut donc être modifié ou supprimé par un administrateur.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RightsDefinitions
Répertorie les droits accordés aux utilisateurs ou aux groupes pour le contenu protégé par le modèle.
Type: | SwitchParameter |
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: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Status
État du modèle :
-Les modèles archivés sont disponibles pour consommer du contenu précédemment protégé, mais ne sont pas affichés aux utilisateurs.
--Les modèles publiés sont disponibles pour les utilisateurs pour protéger le contenu.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-TemplateId
Spécifie le GUID d’un modèle Rights Management.
Vous pouvez utiliser l’applet de commande Get-AadrmTemplate pour obtenir l’ID de modèle de tous les modèles.
Type: | Guid |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |