Get-AipServiceTemplateProperty
Ruft die Eigenschaften einer Schutzvorlage für Azure Information Protection ab.
Syntax
Get-AipServiceTemplateProperty
-TemplateId <Guid>
[-Names]
[-Descriptions]
[-RightsDefinitions]
[-ContentExpirationOption]
[-ContentExpirationDate]
[-ContentValidityDuration]
[-LicenseValidityDuration]
[-ReadOnly]
[-Status]
[-ScopedIdentities]
[-EnableInLegacyApps]
[<CommonParameters>] Beschreibung
Das Cmdlet Get-AipServiceTemplateProperty ruft die angegebenen Eigenschaften einer Schutzvorlage für Azure Information Protection mithilfe des TemplateId-Parameters ab.
Ähnliche Konfigurationsinformationen können auch im Azure-Portal angezeigt werden, aber dieses Cmdlet enthält auch die Vorlagen-GUID.
Sie können Eigenschaften einer Standardvorlage oder einer benutzerdefinierten Vorlage abfragen. Weitere Informationen zu benutzerdefinierten Vorlagen, einschließlich der Konfiguration in den Azure-Portal, finden Sie unter Konfigurieren und Verwalten von Vorlagen für Azure Information Protection.
Verwenden des Azure-Information Protection einheitlichen Bezeichnungsclients?
Der azure Information Protection einheitliche Bezeichnungsclient verwendet indirekt Schutzvorlagen. Wenn Sie über den einheitlichen Bezeichnungsclient verfügen, empfiehlt es sich, beschriftungsbasierte Cmdlets zu verwenden, anstatt Ihre Schutzvorlagen direkt zu ändern.
Weitere Informationen finden Sie in der Microsoft 365-Dokumentation zum Erstellen und Veröffentlichen von Vertraulichkeitsbezeichnungen .
Beispiele
Beispiel 1: Abrufen der Beschreibung und der Nutzungsrechte für eine Vorlage
PS C:\>Get-AipServiceTemplateProperty -TemplateId 28168524-29c3-44f1-9e11-ea6c60bb6428 -Descriptions -RightsDefinitionsDieser Befehl ruft die Beschreibung und die Nutzungsrechte für alle Benutzer oder Gruppen ab, die für die angegebene Schutzvorlage konfiguriert sind.
Beispiel 2: Für alle Vorlagen erhalten Sie den Namen, die Nutzungsrechte, ob eine Standardvorlage und ob veröffentlicht oder archiviert.
PS C:\>$templates = Get-AipServiceTemplate PS C:\>foreach ($template in $templates) {Get-AipServiceTemplateProperty -TemplateId $template.TemplateId -Name -RightsDefinitions -ReadOnly -Status}Der erste Befehl ruft alle Vorlagen-IDs ab und speichert sie in einer Variablen. Der zweite Befehl verwendet dann diese Variable, um den Vorlagennamen, die Nutzungsrechte abzurufen, ob es schreibgeschützt ist (True für eine Standardvorlage , False für eine benutzerdefinierte Vorlage), und den Status (Veröffentlicht oder archiviert) für jede Vorlage.
Parameter
-ContentExpirationDate
Listet das Datum auf, an dem inhalte, die mit der Vorlage geschützt sind, abläuft.
Verwenden Sie diesen Parameter nur, wenn ContentExpirationOption auf OnDate festgelegt ist.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ContentExpirationOption
Ruft die Inhaltsablaufkonfigurationseinstellung für Inhalte ab, die mit der Vorlage geschützt sind.
Einer der folgenden Werte wird zurückgegeben:
Never. Gibt an, dass der Inhalt für unbegrenzte Zeit verfügbar ist.
OnDate. Gibt an, dass der Inhalt an einem bestimmten festen Datum abläuft.
AfterDays. Gibt an, dass der Inhalt für die angegebene Anzahl von Tagen nach Ablauf des Schutzes verfügbar ist.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ContentValidityDuration
Listet die Anzahl der Tage des Schutztags auf, nach dem Inhalte, die mit der Vorlage geschützt sind, ablaufen.
Verwenden Sie diesen Parameter nur, wenn ContentExpirationOption auf AfterDays festgelegt ist.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Descriptions
Listet die Beschreibungen für die Vorlage in allen Gebietsschemas auf.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-EnableInLegacyApps
Gibt das Verhalten einer Abteilungsvorlage in Anwendungen an, die abteilungsbezogene Vorlagen nicht unterstützen (siehe den Parameter ScopedIdentities ).
Wenn "True" festgelegt ist und die Vorlage eine Abteilungsvorlage ist, werden alle Benutzer, die versuchen, Inhalte vor einer Anwendung zu schützen, die die Abteilungsvorlagen nicht unterstützt, die Vorlage sehen und daher unabhängig davon, ob die Benutzer Mitglieder des Zielbereichs der Vorlage sind oder nicht.
Wenn "False" festgelegt ist, sehen keine Benutzer die Vorlage in Anwendungen, die abteilungsbezogene Vorlagen nicht unterstützen, auch wenn die Benutzer Mitglieder des Zielbereichs der Vorlage sind.
Diese Einstellung hat keine Auswirkung auf Vorlagen, die keine Abteilungsvorlagen sind. Zudem hat sie keine Auswirkung auf Anwendungen, die Abteilungsvorlagen systemeigen unterstützen.
Dieser Parameter entspricht der Vorlage " Diese Vorlage anzeigen" allen Benutzern, wenn die Anwendungen das Kontrollkästchen "Benutzeridentität" nicht unterstützen, wenn Sie ANWENDUNGSKOMPATIBILITÄT im klassischen Azure-Portal konfigurieren (jetzt eingestellt). Es gibt keine entsprechende Einstellung im Azure-Portal.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-LicenseValidityDuration
Listet die Anzahl der Tage auf, auf die Inhalte offline zugänglich sind, nachdem eine Lizenz zur Nutzung erworben wurde.
-1 gibt unbegrenzten Zugriff an.
0 gibt an, dass eine Lizenz für jede Verwendung abgerufen werden muss und dass Inhalte nur online verfügbar sind.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Names
Listet die Namen für die Vorlage in allen Gebietsschemas auf.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ReadOnly
Gibt an, ob die Vorlage eine Standardvorlage (True) ist und daher nicht bearbeitet oder gelöscht werden kann oder eine benutzerdefinierte Vorlage (False) und daher von einem Administrator bearbeitet oder gelöscht werden kann.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RightsDefinitions
Listet die Rechte auf, die Benutzern oder Gruppen für den Inhalt gewährt werden, der mit der Vorlage geschützt ist.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ScopedIdentities
Listet die Benutzer nach E-Mail-Adresse (Konto oder Gruppe) auf, die Abteilungsvorlagen aus Anwendungen anzeigen und daher auch auswählen können.
Damit die angegebenen Benutzer die Vorlagen anzeigen können, muss die Anwendung Abteilungsvorlagen unterstützen oder den Parameter "EnableInLegacyApps " auf "True" festlegen.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Status
Der Status der Vorlage:
-Archivierte Vorlagen sind verfügbar, um zuvor geschützte Inhalte zu nutzen, werden jedoch nicht für Benutzer angezeigt.
-Veröffentlichte Vorlagen stehen Benutzern zur Verfügung, um Inhalte zu schützen.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-TemplateId
Gibt die GUID einer Schutzvorlage an.
Sie können das Cmdlet "Get-AipServiceTemplate " verwenden, um die Vorlagen-ID aller Vorlagen abzurufen.
| Type: | Guid |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |