Sdílet prostřednictvím

ConvertFrom-SddlString

  • Reference
Modul:
Microsoft.PowerShell.Utility

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

Syntax

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 pomocí rutiny Get-Acl získá popisovač zabezpečení pro složku C:\Windows 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í.

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í pro klíč 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í.

Pomocí parametru -Type určuje, ž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í pro klíč 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í.

Parametr nepoužívá -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.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Type

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

Tento parametr přijímá tyto hodnoty:

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

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

CryptoKeyRights a ActiveDirectoryRights nejsou podporovány v PowerShellu v6 a vyšších verzích.

Type:Microsoft.PowerShell.Commands.ConvertFromSddlStringCommand+AccessRightTypeNames
Accepted values:FileSystemRights, RegistryRights, ActiveDirectoryRights, MutexRights, SemaphoreRights, CryptoKeyRights, EventWaitHandleRights
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.