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 angegebene 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 im Azure-Portal, finden Sie unter Konfigurieren und Verwalten von Vorlagen für Azure Information Protection.
Verwenden des Azure Information Protection-Clients für einheitliche Bezeichnungen?
Der Azure Information Protection-Client für einheitliche Bezeichnungen verwendet Indirekt Schutzvorlagen. Wenn Sie über den Client für einheitliche Bezeichnungen verfügen, empfiehlt es sich, bezeichnungsbasierte Cmdlets zu verwenden, anstatt Ihre Schutzvorlagen direkt zu ändern.
Weitere Informationen finden Sie unter Erstellen und Veröffentlichen von Vertraulichkeitsbezeichnungen in der Microsoft 365-Dokumentation.
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: Rufen Sie für alle Vorlagen 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 Verwendungsrechte abzurufen, unabhängig davon, ob es schreibgeschützt ist (True für eine Standardvorlage, False für eine benutzerdefinierte Vorlage) und den Status (Veröffentlicht oder archivierten) für jede Vorlage.
Parameter
-ContentExpirationDate
Listet das Datum auf, an dem inhalte, die mit der Vorlage geschützt sind, ablaufen.
Verwenden Sie diesen Parameter nur, wenn ContentExpirationOption- auf OnDate-festgelegt ist.
| Typ: | SwitchParameter |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-ContentExpirationOption
Ruft die Einstellung für die Inhaltsablaufkonfiguration für Inhalte ab, die mit der Vorlage geschützt sind.
Einer der folgenden Werte wird zurückgegeben:
Nie. Gibt an, dass Inhalte unbegrenzt verfügbar sind.
OnDate-. Gibt an, dass Inhalte zu einem bestimmten festen Datum ablaufen.
AfterDays. Gibt an, dass Inhalte für die angegebene Anzahl von Tagen nach dem Schutz verfügbar sind.
| Typ: | SwitchParameter |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-ContentValidityDuration
Listet die Anzahl der Tage ab dem Tag des Schutzes auf, nach dem inhalte, die mit der Vorlage geschützt sind, ablaufen.
Verwenden Sie diesen Parameter nur, wenn ContentExpirationOption- auf AfterDays-festgelegt ist.
| Typ: | SwitchParameter |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-Descriptions
Listet die Beschreibungen für die Vorlage in allen Gebietsschemas auf.
| Typ: | SwitchParameter |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-EnableInLegacyApps
Gibt das Verhalten einer Abteilungsvorlage in Anwendungen an, die Abteilungsvorlagen 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 abteilungsbezogene Vorlagen 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, wird die Vorlage in Anwendungen, die keine Abteilungsvorlagen unterstützen, nicht angezeigt und daher nicht ausgewählt, auch wenn die Benutzer Mitglieder des Zielbereichs der Vorlage sind.
Diese Einstellung wirkt sich nicht auf Vorlagen aus, die keine Abteilungsvorlagen sind, und hat auch keine Auswirkungen auf Anwendungen, die abteilungseigene Vorlagen nativ unterstützen.
Dieser Parameter entspricht funktional der Diese Vorlage allen Benutzern anzeigen, wenn die Anwendungen die Benutzeridentität nicht unterstützen Kontrollkästchen, wenn Sie ANWENDUNGSKOMPATIBILITÄTs- im klassischen Azure-Portal konfigurieren (jetzt eingestellt). Im Azure-Portal gibt es keine entsprechende Einstellung.
| Typ: | SwitchParameter |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-LicenseValidityDuration
Listet die Anzahl der Tage auf, auf die Inhalte offline zugegriffen werden kann, nachdem eine Lizenz zum Nutzen dieser Lizenz erworben wurde.
-1 gibt unbegrenzten Zugriff an.
0 gibt an, dass für jede Nutzung eine Lizenz abgerufen werden muss und dass Inhalte nur online verfügbar sind.
| Typ: | SwitchParameter |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-Names
Listet die Namen für die Vorlage in allen Gebietsschemas auf.
| Typ: | SwitchParameter |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | 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.
| Typ: | SwitchParameter |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-RightsDefinitions
Listet die Rechte auf, die Benutzern oder Gruppen für die Inhalte gewährt werden, die mit der Vorlage geschützt sind.
| Typ: | SwitchParameter |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-ScopedIdentities
Listet die Benutzer nach E-Mail-Adresse (Konto oder Gruppe) auf, die Abteilungsvorlagen aus Anwendungen anzeigen und daher auswählen können.
Damit die angegebenen Benutzer die Vorlagen anzeigen können, muss die Anwendung Abteilungsvorlagen unterstützen oder den parameter EnableInLegacyApps Parameter muss auf Truefestgelegt werden.
| Typ: | SwitchParameter |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-Status
Der Status der Vorlage:
- Archivierte Vorlagen stehen zur Nutzung zuvor geschützter Inhalte zur Verfügung, werden benutzern jedoch nicht angezeigt.
- Veröffentlichten Vorlagen stehen Benutzern zum Schutz von Inhalten zur Verfügung.
| Typ: | SwitchParameter |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-TemplateId
Gibt die GUID einer Schutzvorlage an.
Sie können das cmdlet Get-AipServiceTemplate verwenden, um die Vorlagen-ID aller Vorlagen abzurufen.
| Typ: | Guid |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |