Udostępnij za pośrednictwem

Get-AipServiceTemplateProperty

  • Odwołanie
Moduł:
AIPService

Pobiera właściwości szablonu ochrony dla usługi Azure Information Protection.

Składnia

Get-AipServiceTemplateProperty
   -TemplateId <Guid>
   [-Names]
   [-Descriptions]
   [-RightsDefinitions]
   [-ContentExpirationOption]
   [-ContentExpirationDate]
   [-ContentValidityDuration]
   [-LicenseValidityDuration]
   [-ReadOnly]
   [-Status]
   [-ScopedIdentities]
   [-EnableInLegacyApps]
   [<CommonParameters>]

Opis

Polecenie cmdlet Get-AipServiceTemplateProperty pobiera określone właściwości szablonu ochrony dla usługi Azure Information Protection przy użyciu parametru TemplateId.

Podobne informacje o konfiguracji można również wyświetlić w witrynie Azure Portal, ale to polecenie cmdlet zawiera również identyfikator GUID szablonu.

Możesz wykonywać zapytania dotyczące właściwości szablonu domyślnego lub szablonu niestandardowego. Aby uzyskać więcej informacji na temat szablonów niestandardowych, w tym sposobu ich konfigurowania w witrynie Azure Portal, zobacz Konfigurowanie szablonów usługi Azure Information Protection i zarządzanie nimi.

Korzystanie z ujednoliconego klienta etykietowania usługi Azure Information Protection?

Klient ujednoliconego etykietowania usługi Azure Information Protection pośrednio używa szablonów ochrony. Jeśli masz klienta ujednoliconego etykietowania, zalecamy używanie poleceń cmdlet opartych na etykietach zamiast bezpośredniego modyfikowania szablonów ochrony.

Aby uzyskać więcej informacji, zobacz Tworzenie i publikowanie etykiet poufności w dokumentacji platformy Microsoft 365.

Przykłady

Przykład 1. Pobieranie opisu i praw użytkowania szablonu

PS C:\>Get-AipServiceTemplateProperty -TemplateId 28168524-29c3-44f1-9e11-ea6c60bb6428 -Descriptions -RightsDefinitions

To polecenie pobiera opis i prawa użytkowania dla wszystkich użytkowników lub grup skonfigurowanych dla określonego szablonu ochrony.

Przykład 2: W przypadku wszystkich szablonów pobierz nazwę, prawa użytkowania, niezależnie od tego, czy jest to szablon domyślny, czy opublikowany, czy zarchiwizowany

PS C:\>$templates = Get-AipServiceTemplate PS C:\>foreach ($template in $templates) {Get-AipServiceTemplateProperty -TemplateId $template.TemplateId -Name -RightsDefinitions -ReadOnly -Status}

Pierwsze polecenie pobiera wszystkie identyfikatory szablonów i przechowuje je w zmiennej. Drugie polecenie używa tej zmiennej do pobrania nazwy szablonu, praw użytkowania, niezależnie od tego, czy jest tylko do odczytu (true dla szablonu domyślnego, False dla szablonu niestandardowego) oraz stan (Opublikowane lub zarchiwizowane) dla każdego szablonu.

Parametry

-ContentExpirationDate

Wyświetla datę wygaśnięcia zawartości chronionej za pomocą szablonu.

Użyj tego parametru tylko wtedy, gdy ContentExpirationOption jest ustawiona na wartość OnDate.

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-ContentExpirationOption

Pobiera ustawienie konfiguracji wygasania zawartości dla zawartości chronionej za pomocą szablonu.

Zwracana jest jedna z następujących wartości:

  • Nigdy nie. Wskazuje, że zawartość jest dostępna na czas nieokreślony.

  • OnDate. Wskazuje, że zawartość wygasa w określonym ustalonym dniu.

  • AfterDays. Wskazuje, że zawartość jest dostępna dla wskazanej liczby dni po jego ochronie.

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-ContentValidityDuration

Wyświetla liczbę dni od dnia ochrony, po upływie którego zawartość chroniona za pomocą szablonu wygaśnie.

Użyj tego parametru tylko wtedy, gdy ContentExpirationOption jest ustawiona na AfterDays.

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Descriptions

Wyświetla opisy szablonu we wszystkich ustawieniach regionalnych.

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-EnableInLegacyApps

Wskazuje zachowanie szablonu działu w aplikacjach, które nie obsługują szablonów działów (zobacz parametr ScopedIdentities).

Jeśli ustawiono wartość True, a szablon jest szablonem dla działu, wszyscy użytkownicy próbujący chronić zawartość przed aplikacją, która nie obsługuje szablonów działów, zobaczą szablon i w związku z tym będą mogli go wybrać, niezależnie od tego, czy użytkownicy są członkami zakresu docelowego szablonu, czy nie.

W przypadku ustawienia wartości Fałsz żaden użytkownik nie widzi szablonu i dlatego nie może wybrać szablonu w aplikacjach, które nie obsługują szablonów dla działów, nawet jeśli użytkownicy są członkami zakresu docelowego szablonu.

To ustawienie nie ma wpływu na szablony, które nie są szablonami działów, a także nie ma wpływu na aplikacje, które natywnie obsługują szablony dla działów.

Ten parametr jest funkcjonalnie odpowiednikiem Pokaż ten szablon wszystkim użytkownikom, gdy aplikacje nie obsługują tożsamości użytkownika pole wyboru podczas konfigurowania zgodności aplikacji w klasycznym portalu Azure (teraz wycofane). W witrynie Azure Portal nie ma równoważnego ustawienia.

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-LicenseValidityDuration

Wyświetla listę liczby dni, przez które zawartość jest dostępna w trybie offline po uzyskaniu licencji na korzystanie z niej.

-1 wskazuje nieograniczony dostęp.

0 wskazuje, że licencja musi zostać uzyskana dla każdego użycia i że zawartość jest dostępna tylko w trybie online.

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Names

Wyświetla nazwy szablonu we wszystkich ustawieniach regionalnych.

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-ReadOnly

Wskazuje, czy szablon jest domyślnym szablonem (prawda) i dlatego nie można go edytować ani usuwać albo szablonu niestandardowego (fałsz) i dlatego można edytować lub usuwać przez administratora.

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-RightsDefinitions

Wyświetla listę praw przyznanych użytkownikom lub grupom zawartości chronionej za pomocą szablonu.

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-ScopedIdentities

Wyświetla listę użytkowników według adresu e-mail (konta lub grupy), które mogą wyświetlać i w związku z tym wybierać szablony dla działów z aplikacji.

Aby określeni użytkownicy widzieli szablony, aplikacja musi obsługiwać szablony dla działów lub parametr EnableInLegacyApps musi być ustawiony na wartość True.

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Status

Stan szablonu:

- zarchiwizowane szablony są dostępne do korzystania z wcześniej chronionej zawartości, ale nie są wyświetlane użytkownikom.

- Opublikowane szablony są dostępne dla użytkowników w celu ochrony zawartości.

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-TemplateId

Określa identyfikator GUID szablonu ochrony.

Aby uzyskać identyfikator szablonu wszystkich szablonów, możesz użyć polecenia cmdlet Get-AipServiceTemplate.

Typ:Guid
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False