ConvertFrom-SddlString
Mengonversi string SDDL menjadi objek kustom.
Sintaks
All
ConvertFrom-SddlString
[-Sddl] <String>
[-Type <AccessRightTypeNames>]
[<CommonParameters>]
Deskripsi
Cmdlet ini hanya tersedia di platform Windows.
Cmdlet ConvertFrom-SddlString mengonversi string Bahasa Definisi Deskriptor Keamanan menjadi 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 cmdlet Get-Acl untuk mendapatkan deskriptor keamanan untuk folder C:\Windows dan menyimpannya dalam variabel.
Perintah kedua menggunakan cmdlet ConvertFrom-SddlString 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 cmdlet Get-Acl untuk mendapatkan deskriptor keamanan untuk kunci HKLM:\SOFTWARE\Microsoft\ dan menyimpannya dalam variabel.
Perintah kedua menggunakan cmdlet ConvertFrom-SddlString untuk mendapatkan representasi teks string SDDL, yang terkandung dalam properti Sddl objek yang mewakili deskriptor keamanan.
Ini menggunakan parameter -Type 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 cmdlet Get-Acl untuk mendapatkan deskriptor keamanan untuk kunci HKLM:\SOFTWARE\Microsoft\ dan menyimpannya dalam variabel.
Perintah kedua menggunakan cmdlet ConvertFrom-SddlString untuk mendapatkan representasi teks string SDDL, yang terkandung dalam properti Sddl objek yang mewakili deskriptor keamanan.
Ini tidak menggunakan parameter -Type, sehingga hak akses yang ditampilkan adalah untuk sistem file.
Perintah ketiga menggunakan cmdlet ConvertFrom-SddlString dengan parameter -Type, sehingga hak akses yang dikembalikan adalah untuk registri.
Parameter
-Sddl
Menentukan string yang mewakili deskriptor keamanan dalam sintaks SDDL.
Properti parameter
| Jenis: | String |
| Nilai default: | None |
| Mendukung wildcard: | False |
| DontShow: | False |
Kumpulan parameter
(All)
| Position: | 0 |
| Wajib: | True |
| Nilai dari alur: | True |
| Nilai dari alur berdasarkan nama properti: | False |
| Nilai dari argumen yang tersisa: | False |
-Type
Menentukan jenis hak yang diwakili string SDDL.
Nilai yang dapat diterima untuk parameter ini adalah:
- FileSystemRights
- Hak Pendaftaran
- ActiveDirectoryHak
- MutexHak
- SemaphoreRights
- CryptoKeyRights
- EventWaitHandleRights
Secara default cmdlet menggunakan hak sistem file.
CryptoKeyRights dan ActiveDirectoryRights tidak didukung di PowerShell v6 dan yang lebih tinggi.
Properti parameter
| Jenis: | Microsoft.PowerShell.Commands.ConvertFromSddlStringCommand+AccessRightTypeNames |
| Nilai default: | None |
| Nilai yang diterima: | FileSystemRights, RegistryRights, ActiveDirectoryRights, MutexRights, SemaphoreRights, CryptoKeyRights, EventWaitHandleRights |
| Mendukung wildcard: | False |
| DontShow: | False |
Kumpulan parameter
(All)
| Position: | Named |
| Wajib: | False |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | False |
| Nilai dari argumen yang tersisa: | False |
CommonParameters
Cmdlet ini mendukung parameter umum: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, dan -WarningVariable. Untuk informasi selengkapnya, lihat about_CommonParameters.
Input
String
Anda dapat menyalurkan string SDDL ke cmdlet ini.
Catatan
Cmdlet ini hanya tersedia di platform Windows.
