ConvertFrom-SddlString (Microsoft.PowerShell.Utility)

ConvertFrom-SddlString

โมดูล :: Microsoft.PowerShell.Utility

แปลงสตริง SDDL เป็นวัตถุที่กำหนดเอง

ไวยากรณ์

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

คำอธิบาย

cmdlet นี้ใช้ได้เฉพาะบนแพลตฟอร์ม Windows เท่านั้น

ConvertFrom-SddlString cmdlet จะแปลงสตริง Security Descriptor Definition Language เป็นออบเจ็กต์ PSCustomObject แบบกำหนดเองที่มีคุณสมบัติต่อไปนี้: Owner, Group, DiscretionaryAcl, SystemAcl และ RawDescriptor

คุณสมบัติเจ้าของ กลุ่ม DiscretionaryAcl และ SystemAcl มีการแสดงข้อความที่อ่านได้ของสิทธิ์การเข้าถึงที่ระบุในสตริง SDDL

cmdlet นี้ถูกนำมาใช้ใน PowerShell 5.0

ตัวอย่าง

ตัวอย่างที่ 1: แปลงสิทธิ์การเข้าถึงระบบไฟล์ SDDL เป็น PSCustomObject

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

คำสั่งแรกใช้ Get-Acl cmdlet เพื่อรับตัวบอกเกี่ยวกับความปลอดภัยสำหรับโฟลเดอร์ C:\Windows และบันทึกไว้ในตัวแปร

คำสั่งที่สองใช้ ConvertFrom-SddlString cmdlet เพื่อรับการแสดงข้อความของสตริง SDDL ที่มีอยู่ในคุณสมบัติ Sddl ของวัตถุที่แสดงถึงตัวบอกเกี่ยวกับความปลอดภัย

ตัวอย่างที่ 2: แปลงสิทธิ์การเข้าถึงรีจิสทรี SDDL เป็น PSCustomObject

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

คำสั่งแรกใช้ Get-Acl cmdlet เพื่อรับตัวบอกเกี่ยวกับความปลอดภัยสำหรับคีย์ HKLM:\SOFTWARE\Microsoft\ และบันทึกไว้ในตัวแปร

ใช้พารามิเตอร์ -Type เพื่อระบุว่าสตริง SDDL แสดงถึงตัวบอกเกี่ยวกับความปลอดภัยของรีจิสทรี

ตัวอย่างที่ 3: แปลงสิทธิ์การเข้าถึงรีจิสทรี SDDL เป็น PSCustomObject โดยใช้ ConvertFrom-SddlString โดยมีและไม่มีพารามิเตอร์ "-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)

ไม่ได้ใช้พารามิเตอร์ -Type ดังนั้นสิทธิ์การเข้าถึงที่แสดงจึงเป็นสิทธิ์สำหรับระบบไฟล์

คำสั่งที่สามใช้ cmdlet ConvertFrom-SddlString พร้อมด้วยพารามิเตอร์ -Type ดังนั้นสิทธิ์การเข้าถึงที่ส่งคืนจึงเป็นของรีจิสทรี

พารามิเตอร์

-Sddl

ระบุสตริงที่แสดงถึงตัวบอกเกี่ยวกับความปลอดภัยในรูปแบบ SDDL

พิมพ์ :: String
ตำแหน่ง:: 0
ค่าเริ่มต้น:: None
ที่จำเป็น:: True
ยอมรับอินพุตไปป์ไลน์:: True
ยอมรับอักขระตัวแทน:: False

-Type

ระบุประเภทของสิทธิ์ที่สตริง SDDL เป็นตัวแทน

ค่าที่ยอมรับได้สำหรับพารามิเตอร์นี้คือ:

FileSystemRights
RegistryRights
สิทธิ์ Active Directory
MutexRights
SemaphoreRights
CryptoKeyRights
เหตุการณ์ WaitHandleRights

โดยค่าเริ่มต้น cmdlet จะใช้สิทธิ์ของระบบไฟล์

CryptoKeyRights และ ActiveDirectoryRights ไม่ได้รับการสนับสนุนใน PowerShell v6 และสูงกว่า

พิมพ์ :: Microsoft.PowerShell.Commands.ConvertFromSddlStringCommand+AccessRightTypeNames
ค่าที่ยอมรับ:: FileSystemRights, RegistryRights, ActiveDirectoryRights, MutexRights, SemaphoreRights, CryptoKeyRights, EventWaitHandleRights
ตำแหน่ง:: ตั้งชื่อ
ค่าเริ่มต้น:: None
ที่จำเป็น:: False
ยอมรับอินพุตไปป์ไลน์:: False
ยอมรับอักขระตัวแทน:: False

อินพุต

สตริง

คุณสามารถไปป์สตริง SDDL ไปที่ cmdlet นี้

หมายเหตุ

cmdlet นี้ใช้ได้เฉพาะบนแพลตฟอร์ม Windows เท่านั้น

ConvertFrom-SddlString (Microsoft.PowerShell.Utility)