Get-AipServiceTemplateProperty
Hiermee haalt u de eigenschappen op van een beveiligingssjabloon voor Azure Information Protection.
Syntax
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 -RightsDefinitionsMet 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 |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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 |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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 |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Descriptions
Bevat de beschrijvingen voor de sjabloon in alle landinstellingen.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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 |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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 |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Names
Hier worden de namen voor de sjabloon in alle landinstellingen weergegeven.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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 |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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 |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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 |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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 |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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 |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |