Dela via

Set-AipServiceTemplateProperty

  • Referens
Modul:
AIPService

Uppdateringar en egenskap eller egenskaper för en skyddsmall för Azure Information Protection.

Syntax

Set-AipServiceTemplateProperty
   -TemplateId <Guid>
   [-Names <Hashtable>]
   [-Descriptions <Hashtable>]
   [-RightsDefinitions <System.Collections.Generic.List`1[Microsoft.RightsManagementServices.Online.Admin.TemplateRightsDefinition]>]
   [-ContentExpirationOption <ContentExpirationType>]
   [-ContentExpirationDate <DateTime>]
   [-ContentValidityDuration <Int32>]
   [-LicenseValidityDuration <Int32>]
   [-Status <TemplateStatus>]
   [-ScopedIdentities <System.Collections.Generic.List`1[System.String]>]
   [-EnableInLegacyApps <Boolean>]
   [<CommonParameters>]

Description

Cmdleten Set-AipServiceTemplateProperty uppdaterar en egenskap eller egenskaper för en skyddsmall för Azure Information Protection. Du kan uppdatera de flesta av dessa egenskaper i Azure Portal.

När du använder den här cmdleten identifieras mallen med dess GUID, som måste referera till en befintlig skyddsmall. Du kan inte använda den här cmdleten för att uppdatera standardmallarna.

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

Viktigt

När du uppdaterar egenskaper för en skyddsmall skrivs de befintliga inställningarna för dessa egenskaper över (kompletteras inte) utan varning, så se till att ange alla inställningar som du behöver för de egenskaper som du uppdaterar.

Vi rekommenderar att du säkerhetskopierar den befintliga mallen innan du kör den här cmdleten med hjälp av cmdleten Export-AipServiceTemplate . Om du sedan behöver återgå till den ursprungliga konfigurationen kan du använda cmdleten Import-AipServiceTemplate för att återställa mallen.

Mer information om skyddsmallar, inklusive hur du konfigurerar dem i Azure Portal, finns i Konfigurera och hantera mallar för Azure Information Protection.

Använder du Azure Information Protection enhetlig etiketteringsklient?

Azure Information Protection enhetlig etiketteringsklient 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: Uppdatera status för en mall

PS C:\>Set-AipServiceTemplateProperty -TemplateID 28168524-29c3-44f1-9e11-ea6c60bb6428 -Status Published

Det här kommandot anger en mallstatus till Publicerad.

Exempel 2: Ange användare och rättigheter för en skyddsmall

PS C:\> $r1 = New-AipServiceRightsDefinition -EmailAddress marketing@contoso.com -Rights "VIEW","EXPORT"
PS C:\> $r2 = New-AipServiceRightsDefinition -EmailAddress engineering@contoso.com -Rights "VIEW"
PS C:\>Set-AipServiceTemplateProperty -TemplateID 28168524-29c3-44f1-9e11-ea6c60bb6522 -RightsDefinitions ($r1, $r2)

Det här exemplet uppdaterar den befintliga skyddsmallen Ny start – konfidentiellt innehåll för nya användare och rättigheter. Medan den befintliga mallen har beviljats behörighet att visa och exportera till marknadsföringsavdelningen (som inte bör ändras), måste teknikavdelningen nu också ha behörighet att visa.

Eftersom du anger parametern RightsDefinitions skriver över de befintliga inställningarna behåller det första rättighetsdefinitionsobjektet de befintliga inställningarna för marknadsföring, och ett annat rättighetsdefinitionsobjekt skapar de nya behörigheterna för teknikavdelningen.

Exempel 3: Lägga till nya användare och rättigheter till en skyddsmall

PS C:\> $templateid = "7b1db17a-cb1a-41cf-bad7-b452f9d384c1"
PS C:\> [array]$r = New-AipServiceRightsDefinition -EmailAddress pattiful@contoso.com -Rights "DOCEDIT", "EXTRACT"
PS C:\> $r += New-AipServiceRightsDefinition -EmailAddress evannar@vanarsdelltd.com -Rights "VIEW"
PS C:\> $CurrentRightsDefinitions = [array]((get-AipServiceTemplate -TemplateId $templateid).RightsDefinitions)
PS C:\> $ResultingRightsDefinitions = $CurrentRightsDefinitions + $r
PS C:\> Set-AipServiceTemplateProperty -TemplateId $templateid -RightsDefinition $ResultingRightsDefinitions

Den här kommandouppsättningen lägger till två nya användare och deras olika rättigheter till en befintlig mall, utan att skriva över befintliga användare och rättigheter som redan definierats i mallen.

De nya användarna och deras rättigheter är pattiful.contoso.com (en användare i organisationen) som beviljas DOCEDIT - och EXTRACT-rättigheter ; och evannar@vanarsdelltd.com (en användare från en annan organisation) som beviljas VIEW-rättigheter . Dessa användare och deras rättigheter läggs till i rättighetsdefinitionsobjekt med hjälp av en matris, som sedan läggs till i de befintliga rättighetsdefinitionerna för mallen.

Parametrar

-ContentExpirationDate

Anger det datum då innehåll som skyddas med mallen upphör att gälla.

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

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

-ContentExpirationOption

Anger vilken typ av innehåll som ska upphöra att gälla för innehåll som skyddas med mallen.

De acceptabla värdena för den här parametern är:

  • 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 kommer att vara tillgängligt under det angivna antalet dagar efter att det har skyddats.
Typ:ContentExpirationType
Godkända värden:Never, OnDate, AfterDays
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-ContentValidityDuration

Anger antalet dagar från den första skyddsdagen varefter innehåll som skyddas med mallen upphör att gälla.

Använd bara den här parametern om parametern ContentExpirationOption är inställd på AfterDays.

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

-Descriptions

Anger en lista med beskrivningar för mallen.

Skapa namn och beskrivningar för flera språkvariant-ID:t med hjälp av hash-tabellsyntaxen i Windows PowerShell. Det måste finnas minst ett namn/beskrivning-par. Språkvariant-ID:t för namn och beskrivningar måste matcha varandra.

$descriptions = @{}

$descriptions[1033] = "Det här innehållet är konfidentiellt och bör inte delas externt"

$descriptions[1034] = "Este contenido es confidencial y no debe ser compartido fuera de la organizacion"

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

-EnableInLegacyApps

Avgör beteendet för en avdelningsmall i klientprogram som inte stöder avdelningsmallar. I det här scenariot bestämmer du om alla användare kan se avdelningsmallar i listan över tillgängliga mallar, eller om inga användare kan se avdelningsmallar i listan.

Avdelningsmallar kan skapas med parametern ScopedIdentities eller genom att skapa skyddsinställningar i en principomfattning för Azure Information Protection. Avdelningsmallar kan också ha skapats med hjälp av den klassiska Azure-portalen (nu tillbakadragen).

  • Om värdet är True och mallen är en avdelningsmall ser alla användare mallen och kan därför välja den, oavsett om användarna är medlemmar i mallens omfång eller inte.

  • Om värdet är Falskt visas inga användare och kan därför inte välja mallen, ä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å klientprogram som har inbyggt stöd för avdelningsmallar. Den här inställningen har inte heller någon effekt för Outlook på webben som använder Exchange Online i stället för Exchange lokalt och för det här scenariot visas aldrig avdelningsmallar för användare.

Observera att den här inställningen inte påverkar om en användare kan komma åt innehåll som skyddas av en avdelningsmall. det påverkar bara möjligheten för en användare att se och därför välja själva mallen.

Om du har program som inte stöder avdelningsmallar som standard kan du använda ett anpassat skript för nedladdning av RMS-mallar eller andra verktyg för att distribuera dessa mallar till den lokala RMS-klientmappen. Dessa program visar sedan avdelningsmallarna korrekt.

Från en klientdator där alla mallar är nedladdade kan du kopiera mallfilerna och klistra in dem på andra datorer.

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

-LicenseValidityDuration

Anger giltighetsperioden för användningslicenser för innehåll som skyddas med den här mallen. Värdet anges som antalet dagar som innehållet är tillgängligt offline efter att en användningslicens har hämtats (0–9999). Under den här perioden kan användare öppna innehåll som de har använt tidigare utan att kräva en Internetanslutning.

Om du minskar det här värdet får dokumentägare större kontroll genom att se till att innehåll som har återkallats eller som principen har ändrats för inte kan nås för länge efter dessa ändringar.

Genom att öka det här värdet får användarna större frihet att komma åt innehållet utan att det krävs någon Internetanslutning.

Om du vill ange obegränsad åtkomst använder du -1.

Om du vill ange att en användningslicens måste hämtas varje gång det skyddade innehållet används och att innehållet endast är tillgängligt med en Internetanslutning anger du 0.

Varje organisation har en maximal giltighetstid för användningslicenser, vilket är 30 dagar som standard och kan konfigureras med hjälp av Set-AipServiceMaxUseLicenseValidityTime. Värdet som du anger för parametern LicenseValidityDuration måste vara lägre än det värdet.

Om det finns olika värden för användningslicensens giltighetstid, till exempel ett värde för klientorganisationen och ett för mallen, använder Azure Information Protection det mest restriktiva värdet.

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

-Names

Anger en lista med namn för mallen.

Ta inte med något av följande tecken i namnet eftersom inte alla tjänster och program som använder Azure Information Protection har stöd för följande tecken:< > % & / ? ; + \ : #

Skapa namn och beskrivningar för flera språkvariant-ID:t med hjälp av hash-tabellsyntaxen i Windows PowerShell. Det måste finnas minst ett namn/beskrivning-par. Språkvariant-ID:t för namn och beskrivningar måste matcha varandra.

$names = @{}

$names[1033] = "Konfidentiellt innehåll"

$names[1034] = "Contenido confidencial"

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

-RightsDefinitions

Anger en lista över rättighetsdefinitionsobjekt som anges med hjälp av cmdleten New-AipServiceRightsDefinition .

Dessa rättighetsdefinitionsobjekt uttrycker rättigheter att bevilja enskilda användare eller grupper till innehåll som skyddas genom att använda mallen.

Typ:System.Collections.Generic.List`1[Microsoft.RightsManagementServices.Online.Admin.TemplateRightsDefinition]
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-ScopedIdentities

Visar en lista över användare efter 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:System.Collections.Generic.List`1[System.String]
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Status

Anger status för mallen. Giltiga värden är: Publicerade eller Arkiverade.

  • Arkiverade mallar är tillgängliga för att använda innehåll som tidigare skyddats men som inte är synliga för användarna.
  • Publicerade mallar distribueras till användare och görs tillgängliga för att skydda innehåll.
Typ:TemplateStatus
Godkända värden:Archived, Published
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-TemplateId

Anger GUID för en skyddsmall.

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