ConvertFrom-SddlString

  • Referentie
Module:
Microsoft.PowerShell.Utility

Converteert een SDDL-tekenreeks naar een aangepast object.

Syntax

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

Description

Deze cmdlet is alleen beschikbaar op het Windows-platform.

De ConvertFrom-SddlString cmdlet converteert een tekenreeks voor de definitietaal van de beveiligingsdescriptor naar een aangepast PSCustomObject-object met de volgende eigenschappen: Eigenaar, Groep, DiscretionaryAcl, SystemAcl en RawDescriptor.

De eigenschappen Eigenaar, Groep, DiscretionaryAcl en SystemAcl bevatten een leesbare tekstweergave van de toegangsrechten die zijn opgegeven in een SDDL-tekenreeks.

Deze cmdlet is geïntroduceerd in PowerShell 5.0.

Voorbeelden

Voorbeeld 1: Toegangsrechten voor bestandssysteem converteren SDDL naar een PSCustomObject

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

De eerste opdracht gebruikt de Get-Acl cmdlet om de beveiligingsdescriptor op te halen voor de map C:\Windows en slaat deze op in de variabele.

De tweede opdracht gebruikt de ConvertFrom-SddlString cmdlet om de tekstweergave van de SDDL-tekenreeks op te halen, die is opgenomen in de eigenschap Sddl van het object dat de beveiligingsdescriptor vertegenwoordigt.

Voorbeeld 2: Registertoegangsrechten SDDL converteren naar een PSCustomObject

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

De eerste opdracht gebruikt de Get-Acl cmdlet om de beveiligingsdescriptor op te halen voor de SLEUTEL HKLM:\SOFTWARE\Microsoft\ en slaat deze op in de variabele.

De tweede opdracht gebruikt de ConvertFrom-SddlString cmdlet om de tekstweergave van de SDDL-tekenreeks op te halen, die is opgenomen in de eigenschap Sddl van het object dat de beveiligingsdescriptor vertegenwoordigt.

Hierbij wordt de -Type parameter gebruikt om op te geven dat de SDDL-tekenreeks een registerbeveiligingsdescriptor vertegenwoordigt.

Voorbeeld 3: Registertoegangsrechten SDDL converteren naar een PSCustomObject met behulp van ConvertFrom-SddlString met en zonder de 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)

De eerste opdracht gebruikt de Get-Acl cmdlet om de beveiligingsdescriptor op te halen voor de SLEUTEL HKLM:\SOFTWARE\Microsoft\ en slaat deze op in de variabele.

De tweede opdracht gebruikt de ConvertFrom-SddlString cmdlet om de tekstweergave van de SDDL-tekenreeks op te halen, die is opgenomen in de eigenschap Sddl van het object dat de beveiligingsdescriptor vertegenwoordigt.

De parameter wordt niet gebruikt -Type , dus de weergegeven toegangsrechten zijn voor het bestandssysteem.

De derde opdracht maakt gebruik van de ConvertFrom-SddlString cmdlet met de -Type parameter, dus de geretourneerde toegangsrechten zijn voor het register.

Parameters

-Sddl

Hiermee geeft u de tekenreeks voor de beveiligingsdescriptor in SDDL-syntaxis.

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

-Type

Hiermee geeft u het type rechten op dat de SDDL-tekenreeks vertegenwoordigt.

De aanvaardbare waarden voor deze parameter zijn:

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

De cmdlet maakt standaard gebruik van bestandssysteemrechten.

CryptoKeyRights en ActiveDirectoryRights worden niet ondersteund in PowerShell v6 en hoger.

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

Invoerwaarden

String

U kunt een SDDL-tekenreeks doorsluisen naar deze cmdlet.

Notities

Deze cmdlet is alleen beschikbaar op Windows-platforms.