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
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 sur la façon de les configurer dans le portail Azure, consultez Configuration et gestion des modèles pour Azure Information Protection.
Utiliser le client d’étiquetage unifié Azure Information Protection ?
Le client d’étiquetage unifié Azure Information Protection utilise indirectement des modèles de protection. Si vous disposez du 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’un modèle par défaut et qu’il soit 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 s’agisse d’un en lecture seule (
Paramètres
-ContentExpirationDate
Répertorie la date à laquelle le contenu protégé avec le modèle expire.
Utilisez ce paramètre uniquement si ContentExpirationOption a la valeur 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 du contenu protégé par le modèle.
L’une des valeurs suivantes est retournée :
Jamais. Indique que le contenu est disponible indéfiniment.
OnDate. Indique que le contenu expire à une date fixe donnée.
AfterDays. Indique que le contenu est disponible pour le nombre indiqué de jours après sa 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 à partir du jour de la protection après laquelle le contenu protégé avec le modèle expire.
Utilisez ce paramètre uniquement si ContentExpirationOption a la valeur 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 (consultez le paramètre ScopedIdentities).
Si la valeur est 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 qui ne sont pas des modèles de service et n’a pas d’effet sur les applications qui prennent en charge les modèles départementaux en mode natif.
Ce paramètre est fonctionnellement l’équivalent de l'Afficher ce modèle à tous les utilisateurs lorsque les applications ne prennent pas en charge l’identité de l’utilisateur case à cocher lorsque vous configurez COMPATIBILITÉ DES APPLICATIONS dans le portail Azure Classic (désormais mis hors service). 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 où le contenu est 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 les utilisateurs par adresse e-mail (compte ou groupe) qui peuvent voir et donc sélectionner des 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
| 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 :
- modèles de archivés sont disponibles pour consommer du contenu précédemment protégé, mais ne sont pas affichés aux utilisateurs.
- modèles de publiés sont accessibles aux 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 |