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