Delen via

Get-AipServiceTemplateProperty

  • Referentie
Module:
AIPService

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

Syntaxis

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

Description

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

Vergelijkbare configuratiegegevens kunnen ook worden weergegeven in de 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 de Azure Portal.

Gebruikt u de Geïntegreerde labelclient van Azure Information Protection?

De Azure Information Protection unified labeling-client 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, de gebruiksrechten op, of een standaardsjabloon 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 (waar voor een standaardsjabloon, Onwaar voor een aangepaste sjabloon) en de status (gepubliceerd of gearchiveerd) 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 inhoud verloopt op een bepaalde vaste datum.

  • 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 is beveiligd met de sjabloon 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 willen 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 sjabloon weergeven voor alle gebruikers wanneer de toepassingen geen ondersteuning bieden voor gebruikersidentiteit wanneer u APPLICATION COMPATIBILITY configureert in de klassieke Azure-portal (nu buiten gebruik gesteld). Er is geen equivalente instelling in de Azure Portal.

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

-LicenseValidityDuration

Geeft een lijst weer van het aantal dagen dat inhoud offline toegankelijk is nadat een licentie om deze te gebruiken is verkregen.

-1 geeft onbeperkte toegang aan.

0 geeft aan dat er een licentie moet worden verkregen voor elk gebruik en dat 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 (Waar) is 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 van de rechten die aan gebruikers of groepen zijn verleend 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

Hiermee worden de gebruikers weergegeven op 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 zijn 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