Get-AipServiceTemplateProperty
Obtient les propriétés d’un modèle de protection pour Azure Information Protection.
Syntaxe
Get-AipServiceTemplateProperty
-TemplateId <Guid>
[-Names]
[-Descriptions]
[-RightsDefinitions]
[-ContentExpirationOption]
[-ContentExpirationDate]
[-ContentValidityDuration]
[-LicenseValidityDuration]
[-ReadOnly]
[-Status]
[-ScopedIdentities]
[-EnableInLegacyApps]
[<CommonParameters>] Description
L’applet de commande Get-AipServiceTemplateProperty obtient les propriétés spécifiées d’un modèle de protection pour Azure Information Protection, à 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.
Utilisation du client d’étiquetage unifié Azure Information Protection ?
Le client d’étiquetage unifié Azure Information Protection utilise indirectement des modèles de protection. Si vous avez le client d’étiquetage unifié, nous vous recommandons d’utiliser des applets de commande basées sur des étiquettes au lieu de modifier directement vos modèles de protection.
Pour plus d’informations, consultez Créer et publier des étiquettes de confidentialité dans la documentation Microsoft 365.
Exemples
Exemple 1 : Obtenir la description et les droits d’utilisation d’un modèle
PS C:\>Get-AipServiceTemplateProperty -TemplateId 28168524-29c3-44f1-9e11-ea6c60bb6428 -Descriptions -RightsDefinitionsCette commande obtient la description et les droits d’utilisation pour tous les utilisateurs ou groupes configurés pour le modèle de protection 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-AipServiceTemplate PS C:\>foreach ($template in $templates) {Get-AipServiceTemplateProperty -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 |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | 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 |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | 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 |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-Descriptions
Répertorie les descriptions du modèle dans tous les paramètres régionaux.
| Type: | SwitchParameter |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | 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 APPLICATION COMPATIBILITY dans le portail Azure Classic (maintenant supprimé). Il n’existe aucun paramètre équivalent dans le Portail Azure.
| Type: | SwitchParameter |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | 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 disponible uniquement en ligne.
| Type: | SwitchParameter |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-Names
Répertorie les noms du modèle dans tous les paramètres régionaux.
| Type: | SwitchParameter |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | 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 |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | 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 |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | 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 |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | 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 |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-TemplateId
Spécifie le GUID d’un modèle de protection.
Vous pouvez utiliser l’applet de commande Get-AipServiceTemplate pour obtenir l’ID de modèle de tous les modèles.
| Type: | Guid |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |