Sdílet prostřednictvím

ConvertFrom-SddlString

  • Reference
Modul:
Microsoft.PowerShell.Utility

Převede řetězec SDDL na vlastní objekt.

Syntaxe

ConvertFrom-SddlString
                [-Sddl] <String>
                [-Type <AccessRightTypeNames>]
                [<CommonParameters>]

Description

Tato rutina je dostupná jenom na platformě Windows.

Rutina ConvertFrom-SddlString převede řetězec jazyka definice popisovače zabezpečení na vlastní objekt PSCustomObject s následujícími vlastnostmi: Owner, Group, DiscretionaryAcl, SystemAcl a RawDescriptor.

Vlastnosti Owner, Group, DiscretionaryAcl a SystemAcl obsahují čitelné textové vyjádření přístupových práv zadaných v řetězci SDDL.

Tato rutina byla zavedena v PowerShellu 5.0.

Příklady

Příklad 1: Převod přístupových práv systému souborů SDDL na PSCustomObject

$acl = Get-Acl -Path C:\Windows
ConvertFrom-SddlString -Sddl $acl.Sddl

První příkaz použije rutinu Get-Acl k získání popisovače zabezpečení pro složku C:\Windows a uloží ji do proměnné.

Druhý příkaz používá rutinu ConvertFrom-SddlString k získání textové reprezentace řetězce SDDL obsaženého ve vlastnosti Sddl objektu představující popisovač zabezpečení.

Příklad 2: Převod přístupových práv registru SDDL na PSCustomObject

$acl = Get-Acl HKLM:\SOFTWARE\Microsoft\
ConvertFrom-SddlString -Sddl $acl.Sddl -Type RegistryRights

První příkaz pomocí rutiny Get-Acl získá popisovač zabezpečení klíče HKLM:\SOFTWARE\Microsoft\ a uloží ho do proměnné.

Druhý příkaz používá rutinu ConvertFrom-SddlString k získání textové reprezentace řetězce SDDL obsaženého ve vlastnosti Sddl objektu představující popisovač zabezpečení.

Používá -Type parametr k určení, že řetězec SDDL představuje popisovač zabezpečení registru.

Příklad 3: Převod přístupových práv registru SDDL na PSCustomObject pomocí ConvertFrom-SddlString s a bez parametru -Type

$acl = Get-Acl -Path HKLM:\SOFTWARE\Microsoft\

ConvertFrom-SddlString -Sddl $acl.Sddl | ForEach-Object {$_.DiscretionaryAcl[0]}

BUILTIN\Administrators: AccessAllowed (ChangePermissions, CreateDirectories, Delete, ExecuteKey, FullControl, GenericExecute, GenericWrite, ListDirectory, ReadExtendedAttributes, ReadPermissions, TakeOwnership, Traverse, WriteData, WriteExtendedAttributes, WriteKey)

ConvertFrom-SddlString -Sddl $acl.Sddl -Type RegistryRights | ForEach-Object {$_.DiscretionaryAcl[0]}

BUILTIN\Administrators: AccessAllowed (ChangePermissions, CreateLink, CreateSubKey, Delete, EnumerateSubKeys, ExecuteKey, FullControl, GenericExecute, GenericWrite, Notify, QueryValues, ReadPermissions, SetValue, TakeOwnership, WriteKey)

První příkaz pomocí rutiny Get-Acl získá popisovač zabezpečení klíče HKLM:\SOFTWARE\Microsoft\ a uloží ho do proměnné.

Druhý příkaz používá rutinu ConvertFrom-SddlString k získání textové reprezentace řetězce SDDL obsaženého ve vlastnosti Sddl objektu představující popisovač zabezpečení.

Nepoužívá parametr -Type, takže zobrazená přístupová práva jsou určena pro systém souborů.

Třetí příkaz používá rutinu ConvertFrom-SddlString s parametrem -Type, takže vrácená přístupová práva jsou pro registr.

Parametry

-Sddl

Určuje řetězec představující popisovač zabezpečení v syntaxi SDDL.

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

-Type

Určuje typ práv, která řetězec SDDL představuje.

Přijatelné hodnoty pro tento parametr jsou:

  • FileSystemRights
  • RegistryRights
  • ActiveDirectoryRights
  • MutexRights
  • SemaphoreRights
  • CryptoKeyRights
  • EventWaitHandleRights

Ve výchozím nastavení používá rutina práva systému souborů.

CryptoKeyRights a ActiveDirectoryRights nejsou podporované v PowerShellu verze 6 a novějším.

Typ:Microsoft.PowerShell.Commands.ConvertFromSddlStringCommand+AccessRightTypeNames
Přípustné hodnoty:FileSystemRights, RegistryRights, ActiveDirectoryRights, MutexRights, SemaphoreRights, CryptoKeyRights, EventWaitHandleRights
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

Vstupy

String

Do této rutiny můžete převést řetězec SDDL.

Poznámky

Tato rutina je dostupná jenom na platformách Windows.