Sdílet prostřednictvím


New-CustomPermissions

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

Syntaxe

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

Description

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

Pokud je použitý popisek nakonfigurovaný pro nastavení ochrany, vlastní oprávnění ze zásad ad hoc ochrany 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-CustomPermissions -Users user1@contoso.com -Permissions Viewer

Tento příkaz vytvoří objekt zásad ad hoc ochrany, který udělí uživateli user1 z contoso.com práva k používání z oprávnění Revidující a uloží tuto zásadu do proměnné s názvem oprávnění. Tyto zásady ad hoc ochrany se pak dají použít k použití ochrany na soubor nebo soubory.

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ů s datem vypršení platnosti

PS C:\> $permissions = New-CustomPermissions -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ělí práva k používání z oprávnění Revidující a použije také datum vypršení platnosti. Objekt zásad ad hoc ochrany je uložen v proměnné s názvem permissions, která se pak dá použít k použití této ochrany na soubor nebo soubory.

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

Parametry

-ExpirationDate

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

Po tomto datu vypršení platnosti už nebudou mít zadaní uživatelé přístup k souboru nebo souborům. Vlastník a superuživatel však mají vždy přístup k souboru, a to i po dosažení doby vypršení platnosti.

Typ:DateTime
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Permissions

Určuje úroveň oprávnění, která seskupuje práva k používání, která se obvykle používají společně. Pomocí tohoto parametru a parametru Users udělte zadaným uživatelům práva k používání.

Pokud chcete zjistit, která jednotlivá práva k používání jsou zahrnutá v jednotlivých úrovních oprávnění, přečtěte si téma Práva zahrnutá v úrovních oprávnění.

Typ:Permissions
Přípustné hodnoty:Viewer, Reviewer, CoAuthor, CoOwner
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Users

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

Typ:String[]
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

Vstupy

None

Výstupy

System.Object