Bagikan melalui

ConvertFrom-SddlString

  • Referensi
Modul:
Microsoft.PowerShell.Utility

Mengonversi string SDDL menjadi objek kustom.

Sintaks

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

Deskripsi

Cmdlet ini hanya tersedia di platform Windows.

ConvertFrom-SddlString Cmdlet mengonversi string Bahasa Definisi Deskriptor Keamanan ke objek PSCustomObject kustom dengan properti berikut: Pemilik, Grup, DiscretionaryAcl, SystemAcl dan RawDescriptor.

Properti Pemilik, Grup, DiscretionaryAcl, dan SystemAcl berisi representasi teks yang dapat dibaca dari hak akses yang ditentukan dalam string SDDL.

Cmdlet ini diperkenalkan di PowerShell 5.0.

Contoh

Contoh 1: Mengonversi hak akses sistem file SDDL ke PSCustomObject

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

Perintah pertama menggunakan Get-Acl cmdlet untuk mendapatkan deskriptor keamanan untuk folder C:\Windows dan menyimpannya dalam variabel.

Perintah kedua menggunakan ConvertFrom-SddlString cmdlet untuk mendapatkan representasi teks string SDDL, yang terkandung dalam properti Sddl objek yang mewakili deskriptor keamanan.

Contoh 2: Mengonversi hak akses registri SDDL ke PSCustomObject

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

Perintah pertama menggunakan Get-Acl cmdlet untuk mendapatkan deskriptor keamanan untuk kunci HKLM:\SOFTWARE\Microsoft\ dan menyimpannya dalam variabel.

Perintah kedua menggunakan ConvertFrom-SddlString cmdlet untuk mendapatkan representasi teks string SDDL, yang terkandung dalam properti Sddl objek yang mewakili deskriptor keamanan.

Ini menggunakan -Type parameter untuk menentukan bahwa string SDDL mewakili deskriptor keamanan registri.

Contoh 3: Mengonversi hak akses registri SDDL ke PSCustomObject dengan menggunakan ConvertFrom-SddlString dengan dan tanpa parameter '-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)

Perintah pertama menggunakan Get-Acl cmdlet untuk mendapatkan deskriptor keamanan untuk kunci HKLM:\SOFTWARE\Microsoft\ dan menyimpannya dalam variabel.

Perintah kedua menggunakan ConvertFrom-SddlString cmdlet untuk mendapatkan representasi teks string SDDL, yang terkandung dalam properti Sddl objek yang mewakili deskriptor keamanan.

Ini tidak menggunakan -Type parameter , sehingga hak akses yang ditampilkan adalah untuk sistem file.

Perintah ketiga menggunakan ConvertFrom-SddlString cmdlet dengan -Type parameter , sehingga hak akses yang dikembalikan adalah untuk registri.

Parameter

-Sddl

Menentukan string yang mewakili deskriptor keamanan dalam sintaks SDDL.

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

-Type

Menentukan jenis hak yang diwakili string SDDL.

Nilai yang dapat diterima untuk parameter ini adalah:

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

Secara default cmdlet menggunakan hak sistem file.

CryptoKeyRights dan ActiveDirectoryRights tidak didukung di PowerShell v6 dan yang lebih tinggi.

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

Input

String

Anda dapat menyalurkan string SDDL ke cmdlet ini.

Catatan

Cmdlet ini hanya tersedia di platform Windows.