ConvertFrom-SddlString
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
Anda dapat menyalurkan string SDDL ke cmdlet ini.
Catatan
Cmdlet ini hanya tersedia di platform Windows.
Link Terkait
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk