Dela via

Set-AipServiceTemplateProperty

  • Referens
Modul:
AIPService

Uppdaterar 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-portalen.

När du använder den här cmdleten identifieras mallen av 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.

Viktig

När du uppdaterar egenskaperna för en skyddsmall skrivs de befintliga inställningarna för dessa egenskaper över (kompletteras inte) utan förvarning, 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-portalen, finns i Konfigurera och hantera mallar för Azure Information Protection.

Använda azure informationsskyddsklienten för enhetlig etikettering?

Azure Information Protection-klienten för enhetlig etikettering 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 en malls status

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 i 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 uppsättningen med kommandon 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 inom organisationen) som beviljas DOCEDIT- och EXTRAHERA 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ållet som skyddas med mallen upphör att gälla.

Använd endast den här parametern om ContentExpirationOption har angetts till 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 godtagbara 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 endast 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 nationella ID:er med hash-tabellsyntaxen i Windows PowerShell. Det måste finnas minst ett namn/beskrivningspar. Språk-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 hur en avdelningsmall fungerar i klientprogram som inte stöder avdelningsmallar. I det här scenariot bestämmer du om alla användare kan se avdelningsmallar från listan över tillgängliga mallar, eller om inga användare kan se avdelningsmallar i listan.

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

  • Om den är inställd på 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 inställt på Falsekan inga användare se 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 påverkar klientprogram som internt stöder 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 väljer därför själva mallen.

Om du har program som inte stöder avdelningsmallar som standard kan du använda ett anpassat RMS-mallnedladdningsskript eller andra verktyg för att distribuera dessa mallar till den lokala RMS-klientmappen. De här programmen visar sedan avdelningsmallarna på rätt sätt.

Från en klientdator som har laddat ned alla mallar kan du kopiera och sedan klistra in mallfilerna 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 tidigare har använt utan att kräva en Internet-nätverksanslutning.

Om du minskar det här värdet får dokumentägare mer 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.

Om du ökar 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.

När 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 kan ha stöd för följande tecken: < > % & / ? ; + \ : #

Skapa namn och beskrivningar för flera nationella ID:er med hjälp av hash-tabellsyntaxen i Windows PowerShell. Det måste finnas minst ett namn/beskrivningspar. Språk-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ätten 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 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: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 är inte synliga för användare.
  • 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