Add-AipServiceTemplate
Vytvoří šablonu ochrany pro Azure Information Protection.
Syntaxe
Add-AipServiceTemplate
-Descriptions <Hashtable>
-Names <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
Rutina Add-AipServiceTemplate vytvoří šablonu ochrany pro Azure Information Protection se zadaným názvem, popisem a zásadami a nastaví stav šablony na archivaci nebo publikování.
Stejné akce konfigurace lze provést také v Azure Portal.
Důležité
Před použitím této rutiny musíte nejprve vytvořit objekt definice práv, který určuje práva, která chcete udělit a komu pomocí rutiny New-AipServiceRightsDefinition .
Do Azure můžete uložit maximálně 500 vlastních šablon (publikovaných nebo archivovaných). Pokud nemůžete přidat nové šablony, protože jste dosáhli tohoto limitu v důsledku zachování mnoha archivovaných šablon, zvažte jejich místní export, abyste uložili informace místně a pak tyto šablony odebrali v Azure.
Další informace o šablonách ochrany, včetně toho, jak je nakonfigurovat v Azure Portal, najdete v tématu Konfigurace a správa šablon pro azure Information Protection.
Používáte klienta sjednoceného popisování Azure Information Protection?
Klient sjednoceného popisování Azure Information Protection používá šablony ochrany nepřímo. Pokud máte klienta sjednoceného popisování, doporučujeme místo přímé úpravy šablon ochrany používat rutiny založené na popiscích.
Další informace najdete v tématu Vytvoření a publikování popisků citlivosti v dokumentaci k Microsoftu 365.
Příklady
Příklad 1: Vytvoření šablony oddělení pro důvěrný obsah
PS C:\> $names = @{}
PS C:\> $names[1033] = "New Launch - Confidential content"
PS C:\> $names[1034] = " Nuevo Lanzamiento - Contenido confidencial"
PS C:\> $descriptions = @{}
PS C:\> $descriptions[1033] = "This content is confidential for people working on the New Launch project and should not be shared externally"
PS C:\> $descriptions[1034] = "Este contenido es confidencial para empleados trabajando en el proyecto Nuevo Lanzamiento y no debe ser compartido fuera de la organización"
PS C:\> $r1 = New-AipServiceRightsDefinition -EmailAddress marketing@contoso.com -Rights "VIEW","EXPORT"
PS C:\> $r2 = New-AipServiceRightsDefinition -EmailAddress engineering@contoso.com -Rights "VIEW","DOCEDIT"
PS C:\> Add-AipServiceTemplate -Names $names -Descriptions $Descriptions -LicenseValidityDuration 5 -RightsDefinitions $r1, $r2 -ScopedIdentities engineering@contoso.com -Status PublishedTento příklad vytvoří šablonu oddělení pro techniky, když pracují na projektu Nové spuštění. Šablona má název New Launch – Důvěrné obsahy a obsahuje názvy a popisy v angličtině a ve španělštině. Uděluje oprávnění k zobrazení a exportu marketingovému oddělení (umožňuje jim zobrazit a uložit do nechráněného souboru) pomocí marketing@contoso.com skupiny a oprávnění Zobrazit a DocEdit (umožňuje jim zobrazit a upravit obsah, ale ne uložit změny) do technického oddělení pomocí engineering@contoso.com skupiny.
Parametry
-ContentExpirationDate
Určuje datum, kdy vyprší platnost obsahu chráněného šablonou.
Tento parametr použijte pouze v případě, že je parametr ContentExpirationOption nastavený na OnDate.
| Typ: | DateTime |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | 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ší k určitému pevnému datu.
AfterDays. Označuje, že obsah je k dispozici pro zadaný počet dní po jeho uzamčení.
| Typ: | ContentExpirationType |
| Přípustné hodnoty: | Never, OnDate, AfterDays |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-ContentValidityDuration
Určuje počet dnů od prvního dne ochrany, po kterém vyprší platnost obsahu chráněného šablonou.
Tento parametr použijte pouze v případě, že je parametr ContentExpirationOption nastavený na AfterDays.
| Typ: | Int32 |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-Descriptions
Určuje seznam popisů šablony.
Vytvořte názvy a popisy pro více ID národního prostředí pomocí syntaxe hash-table 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. Pokud je zadané ID národního prostředí, musí jeho hodnota obsahovat neprázdný řetězec.
$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 organización"
| Typ: | Hashtable |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | True |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-EnableInLegacyApps
Určuje chování šablony oddělení v aplikacích, které nepodporují šablony oddělení (viz parametr ScopedIdentities ).
Pokud je šablona nastavená na Hodnotu True a šablona je šablona oddělení, všichni uživatelé, kteří se snaží chránit obsah před aplikací, která nepodporuje šablony oddělení, uvidí tuto šablonu, a proto ji budou moct vybrat bez ohledu na to, jestli jsou uživatelé členy cílového oboru šablony nebo ne.
Pokud je nastavená hodnota False, žádní uživatelé nevidí a proto nemůžou vybrat šablonu v aplikacích, které nepodporují šablony oddělení, 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 aplikace, které nativně podporují šablony oddělení.
Poznámka: Tento parametr je funkčně ekvivalentní této šabloně všem uživatelům, pokud aplikace nepodporují identitu uživatele , pokud jste nakonfigurovali kompatibilitu APLIKACÍ na portálu Azure Classic. Klasický portál je teď vyřazený a v Azure Portal neexistuje ekvivalentní nastavení.
Klient Azure Information Protection podporuje šablony oddělení, zatímco Outlook na webu a protokol Exchange ActiveSync jsou příklady aplikací, které aktuálně nepodporují šablony oddělení. U těchto aplikací Exchange (a všech ostatních aplikací, které nemůžou podporovat šablony oddělení), musíte se rozhodnout, jestli můžou všichni uživatelé vybrat šablonu oddělení ze seznamu dostupných šablon nebo že žádní uživatelé nemůžou ze seznamu vybrat šablonu oddělení.
Toto nastavení nemá vliv na to, jestli má uživatel přístup k obsahu chráněnému šablonou oddělení; má vliv jenom na schopnost uživatele vybrat samotnou šablonu.
Pokud máte aplikace, které ve výchozím nastavení nepodporují šablony oddělení, můžete tyto šablony nasadit do místní složky klienta SLUŽBY RMS pomocí vlastního skriptu 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čů.
| Typ: | Boolean |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-LicenseValidityDuration
Určuje dobu platnosti licencí na používání obsahu, který je chráněn touto šablonou.
Hodnota se zadává jako počet dnů, po získání licence k použití (0–9999) je obsah dostupný 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ásady změnily, nebudou moc dlouho po těchto změnách přístupné.
Zvýšení této hodnoty dává uživatelům větší svobodu přístupu k obsahu bez nutnosti připojení k internetu.
Chcete-li zadat neomezený přístup, použijte -1. Chcete-li 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-AipServiceMaxUseLicenseValidityTime. Hodnota, kterou zadáte pro parametr LicenseValidityDuration , musí být nižší než tato hodnota.
Pokud existují různé hodnoty pro dobu platnosti licence pro použití, například jednu hodnotu pro tenanta a jednu pro šablonu, Azure Information Protection používá nejvíce omezující hodnotu.
| Typ: | Int32 |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | 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:< > % & / ? ; + \ : #
Vytvořte názvy a popisy pro více ID národního prostředí pomocí syntaxe hash-table 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. Pokud je zadané ID národního prostředí, musí jeho hodnota obsahovat neprázdný řetězec.
$names = @{}
$names[1033] = "Důvěrný obsah"
$names[1034] = "Contenido confidencial"
| Typ: | Hashtable |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | True |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-RightsDefinitions
Určuje seznam objektů definic práv určených pomocí rutiny New-AipServiceRightsDefinition .
Tyto objekty definice práv vyjadřují práva k udělení jednotlivých uživatelů nebo skupin obsahu chráněnému použitím šablony.
Objekty definice práv obsahují e-mailovou adresu identity a práva, která k ní mají být přiřazena.
| Typ: | System.Collections.Generic.List`1[Microsoft.RightsManagementServices.Online.Admin.TemplateRightsDefinition] |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-ScopedIdentities
Zobrazí seznam uživatelů podle e-mailové adresy (účtu nebo skupiny), které můžou zobrazit a vybrat šablony oddělení z aplikací.
Aby se zadané uživatele zobrazily šablony, musí aplikace podporovat šablony oddělení nebo musí být parametr EnableInLegacyApps nastaven na Hodnotu True.
| Typ: | System.Collections.Generic.List`1[System.String] |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-Status
Určuje stav šablony.
Povolené hodnoty jsou archivovány a publikovány.
Archivované šablony jsou k dispozici pro využívání dříve chráněného obsahu, ale nejsou viditelné pro uživatele.
Publikované šablony se distribuují uživatelům a zpřístupní se k ochraně obsahu.
| Typ: | TemplateStatus |
| Přípustné hodnoty: | Archived, Published |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
Vstupy
System.String[],System.String[],System.String[],System.string,System.DateTime,System.int,System.int
-Názvy $Names ; Jeden nebo více názvů šablony v různých jazycích, které se mají prezentovat uživatelům v závislosti na národním prostředí systému.
[-Popisy $Descriptions] ; Jeden nebo více popisů šablony v různých jazycích, které se mají prezentovat uživatelům v závislosti na národním prostředí systému.
[-RightsDefinitions {$r 1,$r 2,...}] ; Seznam definic práv ve formě objektů Rights Definition .
[-ContentExpirationOption ContentExpirationType.Never| OnDate| AfterDays] ; Typ vypršení platnosti obsahu pro obsah chráněný šablonou
[-ContentExpirationDate DateTime] ; Datum nebo čas vypršení platnosti obsahu, pokud je hodnota ContentExpirationOption nastavená na Hodnotu OnDate.
[-ContentValidityDuration int] ; Počet dnů, po které je obsah k dispozici, je chráněn, pokud je ContentExpirationOption nastaven na AfterDays.
[-LicenseValidityDuration int] ; Počet dnů, po které je obsah dostupný online, dokud nevyprší platnost (0–9999). Chcete-li zadat neomezený přístup, použijte -1. Chcete-li určit, že licence musí být získána pro každé použití a že obsah je k dispozici pouze online, použijte 0.
[-Status TemplateStatus.Archived| Publikováno] ; Stav šablony Archivované šablony jsou k dispozici pro využívání dříve chráněného obsahu, ale nejsou prezentovány uživatelům. Publikované šablony se distribuují uživatelům a zpřístupní se pro ochranu obsahu.
Vytvořte názvy a popisy pro více ID národního prostředí pomocí syntaxe hash-table 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. Pokud je zadané ID národního prostředí, musí jeho hodnota obsahovat neprázdný řetězec.
$names = @{}
$names[1033] = "Důvěrný obsah"
$names[1034] = "Contenido confidencial"
$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 organización"
Tato práva jsou určena jako seznam objektů definic práv , které obsahují e-mailovou adresu pro identitu a práva, která k ní mají být přiřazena.