Dela via

Get-AipServiceTemplateProperty

  • Referens
Modul:
AIPService

Hämtar egenskaperna för en skyddsmall för Azure Information Protection.

Syntax

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

Description

Cmdleten Get-AipServiceTemplateProperty hämtar angivna egenskaper för en skyddsmall för Azure Information Protection med hjälp av parametern TemplateId.

Liknande konfigurationsinformation kan också visas i Azure Portal, men den här cmdleten innehåller även mallens GUID.

Du kan fråga efter egenskaper för en standardmall eller en anpassad mall. Mer information om anpassade mallar, inklusive hur du konfigurerar dem i Azure Portal finns i Konfigurera och hantera mallar för Azure Information Protection.

Använda Azure Information Protection enhetlig etiketteringsklient?

Azure Information Protection enhetliga etiketteringsklienten använder indirekt skyddsmallar. Om du har klienten för enhetlig etikettering rekommenderar vi att du använder etikettbaserade cmdletar i stället för att ändra dina skyddsmallar direkt.

Mer information finns i Skapa och publicera känslighetsetiketter i Microsoft 365-dokumentationen.

Exempel

Exempel 1: Hämta beskrivningen och användningsrättigheterna för en mall

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

Det här kommandot hämtar beskrivningen och användningsrättigheterna för alla användare eller grupper som har konfigurerats för den angivna skyddsmallen.

Exempel 2: För alla mallar hämtar du namnet, användningsrättigheterna, om en standardmall och om den är publicerad eller arkiverad

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

Det första kommandot hämtar alla mall-ID:t och lagrar dem i en variabel. Det andra kommandot använder sedan den här variabeln för att hämta mallnamnet, användningsrättigheterna, oavsett om den är skrivskyddad (Sant för en standardmall, Falskt för en anpassad mall) och statusen (Publicerad eller Arkiverad) för varje mall.

Parametrar

-ContentExpirationDate

Visar datum då innehållet som skyddas med mallen upphör att gälla.

Använd endast den här parametern om ContentExpirationOption är inställt på OnDate.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-ContentExpirationOption

Hämtar konfigurationsinställningen för förfallodatum för innehåll som skyddas med mallen.

Ett av följande värden returneras:

  • Aldrig. Anger att innehållet är tillgängligt på obestämd tid.

  • OnDate. Anger att innehållet upphör att gälla vid ett visst fast datum.

  • AfterDays. Anger att innehållet är tillgängligt under det angivna antalet dagar efter att det har skyddats.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-ContentValidityDuration

Visar en lista över antalet dagar från dagen för skydd varefter innehåll som skyddas med mallen upphör att gälla.

Använd endast den här parametern om ContentExpirationOption är inställt på AfterDays.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Descriptions

Visar beskrivningarna för mallen på alla språk.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-EnableInLegacyApps

Anger beteendet för en avdelningsmall i program som inte stöder avdelningsmallar (se parametern ScopedIdentities ).

Om den är inställd på Sant och mallen är en avdelningsmall ser alla användare som försöker skydda innehåll från ett program som inte stöder avdelningsmallar mallen och kan därför välja den, oavsett om användarna är medlemmar i mallens målomfång eller inte.

Om värdet är Falskt ser inga användare och kan därför inte välja mallen i program som inte stöder avdelningsmallar, även om användarna är medlemmar i mallens målomfång.

Den här inställningen påverkar inte mallar som inte är avdelningsmallar och som inte heller har någon effekt på program som internt stöder avdelningsmallar.

Den här parametern motsvarar funktionellt kryssrutan Visa den här mallen för alla användare när programmen inte stöder användaridentitet när du konfigurerar PROGRAMKOMPATIBILITET i den klassiska Azure-portalen (nu har dragits tillbaka). Det finns ingen motsvarande inställning i Azure Portal.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-LicenseValidityDuration

Visar hur många dagar innehållet är tillgängligt offline efter att en licens för att använda den har hämtats.

-1 anger obegränsad åtkomst.

0 anger att en licens måste hämtas för varje användning och att innehållet endast är tillgängligt online.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Names

Visar namnen på mallen på alla språk.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-ReadOnly

Anger om mallen är en standardmall (True) och därför inte kan redigeras eller tas bort, eller om en anpassad mall (false) och därför kan redigeras eller tas bort av en administratör.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-RightsDefinitions

Visar en lista över de rättigheter som beviljas användare eller grupper för det innehåll som skyddas med mallen.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-ScopedIdentities

Visar en lista över användare via e-postadress (konto eller grupp) som kan se och därför välja avdelningsmallar från program.

För att de angivna användarna ska kunna se mallarna måste programmet ha stöd för avdelningsmallar, eller så måste parametern EnableInLegacyApps anges till True.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Status

Status för mallen:

- Arkiverade mallar är tillgängliga för användning av tidigare skyddat innehåll men visas inte för användare.

- Publicerade mallar är tillgängliga för användare för att skydda innehåll.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-TemplateId

Anger GUID för en skyddsmall.

Du kan använda cmdleten Get-AipServiceTemplate för att hämta mall-ID:t för alla mallar.

Typ:Guid
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False