ConvertFrom-SddlString
Konvertiert eine SDDL-Zeichenfolge in ein benutzerdefiniertes Objekt.
Syntax
ConvertFrom-SddlString
[-Sddl] <String>
[-Type <AccessRightTypeNames>]
[<CommonParameters>]
Beschreibung
Dieses Cmdlet ist nur auf der Windows-Plattform verfügbar.
Das ConvertFrom-SddlString
Cmdlet konvertiert eine Security Descriptor Definition Language-Zeichenfolge in ein benutzerdefiniertes PSCustomObject -Objekt mit den folgenden Eigenschaften: Owner, Group, DiscretionaryAcl, SystemAcl und RawDescriptor.
Die Eigenschaften "Owner", "Group", "DiscretionaryAcl" und "SystemAcl" enthalten eine lesbare Textdarstellung der in einer SDDL-Zeichenfolge angegebenen Zugriffsrechte.
Dieses Cmdlet wurde in PowerShell 5.0 eingeführt.
Beispiele
Beispiel 1: Konvertieren von Dateisystemzugriffsrechten SDDL in ein PSCustomObject
$acl = Get-Acl -Path C:\Windows
ConvertFrom-SddlString -Sddl $acl.Sddl
Der erste Befehl verwendet das Get-Acl
Cmdlet, um den Sicherheitsdeskriptor für den Ordner "C:\Windows" abzurufen und in der Variablen zu speichern.
Der zweite Befehl verwendet das ConvertFrom-SddlString
Cmdlet, um die Textdarstellung der SDDL-Zeichenfolge abzurufen, die in der Sddl-Eigenschaft des Objekts enthalten ist, das den Sicherheitsdeskriptor darstellt.
Beispiel 2: Konvertieren von Registrierungszugriffsrechten SDDL in ein PSCustomObject
$acl = Get-Acl HKLM:\SOFTWARE\Microsoft\
ConvertFrom-SddlString -Sddl $acl.Sddl -Type RegistryRights
Der erste Befehl verwendet das Get-Acl
Cmdlet, um den Sicherheitsdeskriptor für den HKLM:\SOFTWARE\Microsoft\-Schlüssel abzurufen und in der Variablen zu speichern.
Der zweite Befehl verwendet das ConvertFrom-SddlString
Cmdlet, um die Textdarstellung der SDDL-Zeichenfolge abzurufen, die in der Sddl-Eigenschaft des Objekts enthalten ist, das den Sicherheitsdeskriptor darstellt.
Er verwendet den -Type
Parameter, um anzugeben, dass die SDDL-Zeichenfolge einen Registrierungssicherheitsdeskriptor darstellt.
Beispiel 3: Konvertieren von Registrierungszugriffsrechten SDDL in ein PSCustomObject mithilfe von ConvertFrom-SddlString mit und ohne den 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)
Der erste Befehl verwendet das Get-Acl
Cmdlet, um den Sicherheitsdeskriptor für den HKLM:\SOFTWARE\Microsoft\-Schlüssel abzurufen und in der Variablen zu speichern.
Der zweite Befehl verwendet das ConvertFrom-SddlString
Cmdlet, um die Textdarstellung der SDDL-Zeichenfolge abzurufen, die in der Sddl-Eigenschaft des Objekts enthalten ist, das den Sicherheitsdeskriptor darstellt.
Der Parameter wird nicht verwendet -Type
, sodass die angezeigten Zugriffsrechte für das Dateisystem gelten.
Der dritte Befehl verwendet das ConvertFrom-SddlString
Cmdlet mit dem -Type
Parameter, sodass die zurückgegebenen Zugriffsrechte für die Registrierung gelten.
Parameter
-Sddl
Gibt die Zeichenfolge an, die die Sicherheitsbeschreibung in der SDDL-Syntax darstellt.
Type: | String |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Type
Gibt den Typ der Rechte an, die die SDDL-Zeichenfolge darstellt.
Zulässige Werte für diesen Parameter:
- Filesystemrights
- Registryrights
- Activedirectoryrights
- Mutexrights
- Semaphorerights
- Cryptokeyrights
- Eventwaithandlerights
Standardmäßig verwendet das Cmdlet Dateisystemrechte.
CryptoKeyRights und ActiveDirectoryRights werden in PowerShell v6 und höher nicht unterstützt.
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 |
Eingaben
Sie können eine SDDL-Zeichenfolge an dieses Cmdlet weiterleiten.
Hinweise
Dieses Cmdlet ist nur auf Windows-Plattformen verfügbar.
Ähnliche Themen
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für