Freigeben über


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 -RightsDefinitions

Dieser 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.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren: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.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren: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.

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 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.

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 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.

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 den Inhalt gewährt werden, der mit der Vorlage geschützt ist.

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 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.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren: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.

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