Delen via

Get-AipServiceTemplateProperty

  • Referentie
Module:
AIPService

Hiermee haalt u de eigenschappen van een beveiligingssjabloon voor Azure Information Protection op.

Syntaxis

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

Description

De cmdlet Get-AipServiceTemplateProperty krijgt opgegeven eigenschappen van een beveiligingssjabloon voor Azure Information Protection met behulp van de parameter TemplateId.

Vergelijkbare configuratiegegevens kunnen ook worden weergegeven in Azure Portal, maar deze cmdlet bevat ook de sjabloon-GUID.

U kunt query's uitvoeren op eigenschappen van een standaardsjabloon of een aangepaste sjabloon. Zie Sjablonen configureren en beheren voor Azure Information Protection-voor meer informatie over aangepaste sjablonen, waaronder het configureren ervan in Azure Portal.

De geïntegreerde Labelclient van Azure Information Protection gebruiken?

De geïntegreerde Azure Information Protection-labelclient maakt indirect gebruik van beveiligingssjablonen. Als u de geïntegreerde labelclient hebt, raden we u aan om cmdlets op basis van labels te gebruiken in plaats van uw beveiligingssjablonen rechtstreeks te wijzigen.

Zie Vertrouwelijkheidslabels maken en publiceren in de Microsoft 365-documentatie voor meer informatie.

Voorbeelden

Voorbeeld 1: De beschrijving en de gebruiksrechten voor een sjabloon ophalen

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

Met deze opdracht worden de beschrijving en de gebruiksrechten opgehaald voor alle gebruikers of groepen die zijn geconfigureerd voor de opgegeven beveiligingssjabloon.

Voorbeeld 2: Haal voor alle sjablonen de naam op, de gebruiksrechten, of een standaardsjabloon is en of deze is gepubliceerd of gearchiveerd

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

Met de eerste opdracht worden alle sjabloon-id's opgehaald en opgeslagen in een variabele. De tweede opdracht gebruikt deze variabele vervolgens om de sjabloonnaam, de gebruiksrechten op te halen, of deze alleen-lezen is (True voor een standaardsjabloon, False voor een aangepaste sjabloon) en de status (Gepubliceerd of Gearchiveerde) voor elke sjabloon.

Parameters

-ContentExpirationDate

Geeft de datum weer waarop inhoud die is beveiligd met de sjabloon verloopt.

Gebruik deze parameter alleen als ContentExpirationOption- is ingesteld op OnDate-.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-ContentExpirationOption

Hiermee haalt u de configuratie-instelling voor het verlopen van inhoud op voor inhoud die is beveiligd met de sjabloon.

Een van de volgende waarden wordt geretourneerd:

  • Nooit. Geeft aan dat inhoud voor onbepaalde tijd beschikbaar is.

  • OnDate-. Geeft aan dat de inhoud op een bepaalde vaste datum verloopt.

  • AfterDays. Geeft aan dat inhoud beschikbaar is voor het aangegeven aantal dagen nadat deze is beveiligd.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-ContentValidityDuration

Geeft het aantal dagen weer vanaf de dag van beveiliging waarna inhoud die met de sjabloon is beveiligd, verloopt.

Gebruik deze parameter alleen als ContentExpirationOption- is ingesteld op AfterDays.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Descriptions

Bevat de beschrijvingen voor de sjabloon in alle landinstellingen.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-EnableInLegacyApps

Geeft het gedrag aan van een afdelingssjabloon in toepassingen die geen ondersteuning bieden voor afdelingssjablonen (zie de parameter ScopedIdentities).

Als deze optie is ingesteld op Waar en de sjabloon een afdelingssjabloon is, zien alle gebruikers die inhoud proberen te beveiligen tegen een toepassing die geen ondersteuning biedt voor afdelingssjablonen de sjabloon en kunnen deze daarom selecteren, ongeacht of de gebruikers lid zijn van het doelbereik van de sjabloon.

Als deze optie is ingesteld op Onwaar, zien geen gebruikers de sjabloon en kunnen ze daarom niet selecteren in toepassingen die geen ondersteuning bieden voor afdelingssjablonen, zelfs als de gebruikers lid zijn van het doelbereik van de sjabloon.

Deze instelling heeft geen effect op sjablonen die geen afdelingssjablonen zijn en heeft ook geen effect op toepassingen die systeemeigen afdelingssjablonen ondersteunen.

Deze parameter is functioneel het equivalent van de Deze sjabloon weergeven voor alle gebruikers wanneer de toepassingen geen ondersteuning bieden voor gebruikersidentiteit selectievakje wanneer u APPLICATION COMPATIBILITY configureert in de klassieke Azure-portal (nu buiten gebruik gesteld). Er is geen equivalente instelling in Azure Portal.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-LicenseValidityDuration

Hiermee wordt het aantal dagen weergegeven dat inhoud offline toegankelijk is nadat een licentie voor het gebruik ervan is verkregen.

-1 geeft onbeperkte toegang aan.

0 geeft aan dat er voor elk gebruik een licentie moet worden verkregen en dat deze inhoud alleen online beschikbaar is.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Names

Hier worden de namen voor de sjabloon in alle landinstellingen weergegeven.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-ReadOnly

Hiermee wordt aangegeven of de sjabloon een standaardsjabloon is (waar) en daarom niet kan worden bewerkt of verwijderd, of een aangepaste sjabloon (onwaar) en daarom kan worden bewerkt of verwijderd door een beheerder.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-RightsDefinitions

Geeft een lijst weer van de rechten die zijn verleend aan gebruikers of groepen voor de inhoud die is beveiligd met de sjabloon.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-ScopedIdentities

Een lijst met de gebruikers per e-mailadres (account of groep) die afdelingssjablonen uit toepassingen kunnen zien en selecteren.

Voor de opgegeven gebruikers om de sjablonen te kunnen zien, moet de toepassing afdelingssjablonen ondersteunen of moet de parameter EnableInLegacyApps worden ingesteld op True-.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Status

De status van de sjabloon:

- Gearchiveerde sjablonen zijn beschikbaar om eerder beveiligde inhoud te gebruiken, maar worden niet weergegeven voor gebruikers.

- Gepubliceerde-sjablonen zijn beschikbaar voor gebruikers om inhoud te beveiligen.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-TemplateId

Hiermee geeft u de GUID van een beveiligingssjabloon.

U kunt de cmdlet Get-AipServiceTemplate gebruiken om de sjabloon-id van alle sjablonen op te halen.

Type:Guid
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False