Sdílet prostřednictvím

Set-AadrmTemplateProperty

  • Reference
Modul:
AADRM

Aktualizace vlastnost nebo vlastnosti šablony Rights Management.

Syntax

Set-AadrmTemplateProperty
   -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

Poznámka

Tato rutina z modulu AADRM je teď zastaralá. Po 15. červenci 2020 bude tento název rutiny podporován pouze jako alias pro jeho nahrazení v modulu AIPService.

Další informace najdete na stránce přehledu.

Rutina Set-AadrmTemplateProperty aktualizuje vlastnost nebo vlastnosti vlastní šablony azure Rights Management.

Většinu těchto vlastností můžete aktualizovat v Azure Portal.

Při použití této rutiny je šablona identifikována jeho identifikátorem GUID, který musí odkazovat na existující vlastní šablonu Rights Management. Tuto rutinu nelze použít k aktualizaci výchozích šablon.

Id šablony můžete získat pomocí rutiny Get-AadrmTemplate .

Důležité: Když aktualizujete vlastnosti vlastní šablony, stávající nastavení těchto vlastností se přepíše (není doplněno) bez upozornění, takže nezapomeňte zadat všechna nastavení, která potřebujete pro vlastnosti, které aktualizujete.

Osvědčeným postupem je před spuštěním této rutiny zálohovat existující šablonu pomocí rutiny Export-AadrmTemplate . Pokud se pak potřebujete vrátit k původní konfiguraci, můžete šablonu obnovit pomocí rutiny Import-AadrmTemplate .

Další informace o vlastních šablonách, včetně postupu jejich konfigurace v Azure Portal, najdete v tématu Konfigurace a správa šablon pro azure Information Protection.

Příklady

Příklad 1: Aktualizace stavu šablony

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

Tento příkaz nastaví stav šablony na Publikováno.

Příklad 2: Určení uživatelů a práv pro vlastní šablonu

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

Tento příklad aktualizuje stávající vlastní šablonu New Launch – Důvěrné obsah pro nové uživatele a práva. Vzhledem k tomu, že stávající šablona udělila oprávnění Zobrazit a Exportovat marketingovému oddělení (které by se nemělo změnit), musí mít nyní také práva zobrazit.

Vzhledem k tomu, že zadání parametru RightsDefinitions přepíše stávající nastavení, první objekt definice práv uchovává stávající nastavení pro marketing a další objekt definice práv vytvoří nová práva technického oddělení.

Příklad 3: Přidání nových uživatelů a práv do vlastní šablony

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

Tato sada příkazů přidá dva nové uživatele a jejich různá práva k existující šabloně, aniž by přepsali stávající uživatele a práva, která už jsou v šabloně definována.

Noví uživatelé a jejich práva jsou pattiful.contoso.com (uživatel v organizaci), kteří mají udělená práva DOCEDIT a EXTRACT; a evannar@vanarsdelltd.com (uživatel z jiné organizace), který má udělená práva VIEW. Tito uživatelé a jejich práva se přidají do objektů definic práv pomocí pole, které se pak přidá do existujících definic práv šablony.

Parametry

-ContentExpirationDate

Určuje datum, kdy vyprší platnost obsahu chráněného šablonou.

Tento parametr použijte pouze v případě, že je ContentExpirationOption nastaven na OnDate.

Type:DateTime
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ContentExpirationOption

Určuje typ vypršení platnosti obsahu pro obsah chráněný šablonou.

Tento parametr přijímá tyto hodnoty:

  • Nikdy. Označuje, že obsah je k dispozici neomezeně dlouho.
  • OnDate. Označuje, že platnost obsahu vyprší na určité pevné datum.
  • AfterDays. Označuje, že obsah bude k dispozici pro uvedený počet dnů po jeho uzamčení.
Type:ContentExpirationType
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ContentValidityDuration

Určuje počet dnů od prvního dne ochrany, po kterém vyprší platnost obsahu chráněného pomocí šablony.

Tento parametr použijte pouze v případě, že je parametr ContentExpirationOption nastavený na AfterDays.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Descriptions

Určuje seznam popisů šablony.

Vytvořte názvy a popisy pro více ID národního prostředí pomocí syntaxe tabulky hash v Windows PowerShell. Musí existovat alespoň jeden pár názvů a popisů. ID národního prostředí pro názvy a popisy se musí vzájemně shodovat.

$descriptions = @{}

$descriptions[1033] = "Tento obsah je důvěrný a neměl by být sdílen externě"

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

Type:Hashtable
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-EnableInLegacyApps

Určuje chování šablony oddělení v klientských aplikacích, které nepodporují šablony oddělení. V tomto scénáři se rozhodněte, jestli všichni uživatelé uvidí šablony oddělení ze seznamu dostupných šablon nebo že v seznamu neuvidí šablony oddělení.

Šablony oddělení je možné vytvořit pomocí parametru ScopedIdentities nebo vytvořením nastavení ochrany v vymezené zásadě pro Azure Information Protection. Šablony oddělení mohly být také vytvořeny pomocí portálu Azure Classic (nyní vyřazeno).

  • Pokud je nastavená hodnota True a šablona je šablona oddělení, uvidí ji všichni uživatelé, a proto ji budou moct vybrat bez ohledu na to, jestli jsou uživatelé členy oboru šablony nebo ne.

  • Pokud je nastavená hodnota False, nevidí se žádná uživatelé, a proto ji nemůžou vybrat, i když jsou uživatelé členy cílového oboru šablony.

Toto nastavení nemá žádný vliv na šablony, které nejsou šablonami oddělení, a nemá také žádný vliv na klientské aplikace, které nativně podporují šablony oddělení. Toto nastavení také nemá vliv na Outlook na webu, které používají Exchange Online místo místního Exchange a v tomto scénáři se uživatelům nikdy nezobrazí šablony oddělení.

Toto nastavení nemá vliv na to, zda má uživatel přístup k obsahu chráněnému šablonou oddělení; má vliv pouze na schopnost uživatele zobrazit a proto vybrat samotnou šablonu.

Pokud máte aplikace, které ve výchozím nastavení nepodporují šablony oddělení, můžete k nasazení těchto šablon do místní klientské složky RMS použít vlastní skript pro stažení šablon RMS nebo jiné nástroje. Tyto aplikace pak správně zobrazí šablony oddělení.

Z klientského počítače, který stáhl všechny šablony, můžete kopírovat a vkládat soubory šablon do dalších počítačů.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-LicenseValidityDuration

Určuje dobu platnosti licencí na používání obsahu chráněného touto šablonou. Hodnota je zadána jako počet dnů, po získání licence k použití (0–9999) je obsah k dispozici offline. Během tohoto období můžou uživatelé znovu otevřít obsah, ke kterým dříve přistupovali, aniž by museli připojení k internetu.

Snížením této hodnoty získáte větší kontrolu nad vlastníky dokumentů tím, že zajistíte, že obsah, který byl odvolán nebo pro který se zásada změnila, nemůže být po těchto změnách příliš dlouho přístupná.

Zvýšení této hodnoty dává uživatelům větší volnost v přístupu k obsahu bez nutnosti připojení k internetu.

Pokud chcete zadat neomezený přístup, použijte hodnotu -1.

Pokud chcete určit, že licence k použití musí být získána při každém přístupu k chráněnému obsahu a že obsah je k dispozici pouze s připojením k internetu, zadejte hodnotu 0.

Každá organizace má maximální dobu platnosti licence, která je ve výchozím nastavení 30 dní a je možné ji nakonfigurovat pomocí set-AadrmMaxUseLicenseValidityTime. Hodnota, kterou zadáte pro parametr LicenseValidityDuration , musí být nižší než tato hodnota.

Pokud existují různé hodnoty doby platnosti licence pro použití, například jednu hodnotu pro tenanta a jednu pro šablonu, Azure RMS používá nejvíce omezující hodnotu.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Names

Určuje seznam názvů šablony.

Do názvu nezahrnujte žádný z následujících znaků, protože ne všechny služby a aplikace, které používají Azure Information Protection mohou tyto znaky podporovat:< > % & / ? ; + \ : #

Pomocí syntaxe hash tabulky v Windows PowerShell vytvořte názvy a popisy pro více ID národního prostředí. Musí existovat alespoň jeden pár názvů a popisů. ID národního prostředí pro názvy a popisy se musí vzájemně shodovat.

$names = @{}

$names[1033] = "Důvěrný obsah"

$names[1034] = "Contenido confidencial"

Type:Hashtable
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RightsDefinitions

Určuje seznam objektů definic práv určených pomocí rutiny New-AadrmRightsDefinition .

Tyto objekty definice práv vyjadřují práva k udělení individuálním uživatelům nebo skupinám obsahu, který je chráněn použitím šablony.

Type:System.Collections.Generic.List`1[Microsoft.RightsManagementServices.Online.Admin.TemplateRightsDefinition]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ScopedIdentities

Zobrazí seznam uživatelů podle e-mailové adresy (účtu nebo skupiny), které uvidí a proto z aplikací vyberou šablony oddělení.

Aby se zadané uživatele zobrazily šablony, musí aplikace podporovat šablony oddělení nebo musí být parametr EnableInLegacyApps nastaven na Hodnotu True.

Type:System.Collections.Generic.List`1[System.String]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Status

Určuje stav šablony. Platné hodnoty jsou: Publikováno nebo Archivováno.

  • Archivované šablony jsou k dispozici pro využívání obsahu, který byl dříve chráněný, ale nejsou viditelné pro uživatele.
  • Publikované šablony se distribuují uživatelům a zpřístupní se k ochraně obsahu.
Type:TemplateStatus
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-TemplateId

Určuje identifikátor GUID šablony Rights Management.

Type:Guid
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False