New-AIPCustomPermissions

Relevantní pro: Pouze klient sjednoceného popisování AIP

Vytvoří zásady ochrany ad hoc pro vlastní oprávnění.

Syntax

New-AIPCustomPermissions
   -Users <String[]>
   -Permissions <Permissions>
   [-ExpirationDate <DateTime>]
   [<CommonParameters>]

Description

Rutina New-AIPCustomPermissions vytvoří objekt zásad ochrany ad hoc pro vlastní oprávnění, která ukládáte jako proměnnou, a pak slouží k ochraně souboru nebo souborů při spuštění rutiny popisování Set-AIPFileLabel.

Pokud je použitý popisek nakonfigurovaný pro nastavení ochrany, vlastní oprávnění ze zásad ochrany ad hoc nahradí nastavení ochrany z popisku.

Příklady

Příklad 1 – Vytvoření objektu zásad ochrany ad hoc pro jednoho uživatele

PS C:\> $permissions = New-AIPCustomPermissions -Users user1@contoso.com -Permissions Viewer

Tento příkaz vytvoří objekt zásad ochrany ad hoc, který uděluje uživateli1 z contoso.com práv k používání z oprávnění revidujících a uloží tuto zásadu do proměnné pojmenované oprávnění. Tyto ad hoc zásady ochrany se pak dají použít k použití ochrany u souboru nebo souborů.

Pro tento příkaz se nezobrazuje žádný výstup.

Příklad 2 – Vytvoření objektu zásad ochrany ad hoc pro více uživatelů a s datem vypršení platnosti

PS C:\> $permissions = New-AIPCustomPermissions -Users user1@contoso.com, user2@vanarsdel.com -Permissions Reviewer -ExpirationDate (Get-Date -Month 1 -Day 1 -Year 2020)

Tento příkaz vytvoří objekt zásad ochrany ad hoc, který uživatelům z různých organizací uděluje práva k používání z oprávnění Revidujících a použije také datum vypršení platnosti. Objekt zásad ochrany ad hoc je uložen v proměnné pojmenovaná oprávnění, která se pak dají použít k použití této ochrany u souboru nebo souborů.

Pro tento příkaz se nezobrazuje žádný výstup.

Parametry

-ExpirationDate

Určuje datum vypršení platnosti zásad ochrany ad hoc.

Po uplynutí tohoto data vypršení platnosti už nebudou mít zadaná uživatelé přístup k souboru nebo souborům. Vlastník a superuživatel ale budou mít vždy přístup k souboru, a to i po dosažení doby vypršení platnosti.

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

-Permissions

Určuje úroveň oprávnění, která seskupuje práva k používání, která se obvykle používají společně. Tento parametr a parametr Users použijte k udělení práv k používání určeným uživatelům.

Pokud chcete zjistit, která jednotlivá práva k používání jsou zahrnutá v jednotlivých úrovních oprávnění, podívejte se na práva zahrnutá v úrovních oprávnění.

Type:Permissions
Accepted values:Viewer, Reviewer, CoAuthor, CoOwner
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Users

Určuje uživatele, kteří budou mít práva k používání souboru nebo souborů. Tento parametr a parametr Oprávnění použijte k udělení práv určeným uživatelům nebo skupinám.

Type:String[]
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

Vstupy

None

Výstupy

System.Object