ConvertFrom-SddlString
Converte una stringa SDDL in un oggetto personalizzato.
Sintassi
ConvertFrom-SddlString
[-Sddl] <String>
[-Type <Object>]
[<CommonParameters>]
Descrizione
Il ConvertFrom-SddlString
cmdlet converte una stringa del linguaggio di definizione del descrittore di sicurezza in un oggetto PSCustomObject personalizzato con le proprietà seguenti: Owner, Group, DiscretionaryAcl, SystemAcl e RawDescriptor.
Le proprietà Owner, Group, DiscretionaryAcl e SystemAcl contengono una rappresentazione testuale leggibile dei diritti di accesso specificati in una stringa SDDL.
Questo cmdlet è stato introdotto in PowerShell 5.0.
Esempio
Esempio 1: Convertire i diritti di accesso al file system SDDL in un PSCustomObject
$acl = Get-Acl -Path C:\Windows
ConvertFrom-SddlString -Sddl $acl.Sddl
Il primo comando usa il cmdlet per ottenere il Get-Acl
descrittore di sicurezza per la cartella C:\Windows e lo salva nella variabile.
Il secondo comando usa il ConvertFrom-SddlString
cmdlet per ottenere la rappresentazione di testo della stringa SDDL contenuta nella proprietà Sddl dell'oggetto che rappresenta il descrittore di sicurezza.
Esempio 2: Convertire i diritti di accesso del Registro di sistema SDDL in un PSCustomObject
$acl = Get-Acl HKLM:\SOFTWARE\Microsoft\
ConvertFrom-SddlString -Sddl $acl.Sddl -Type RegistryRights
Il primo comando usa il cmdlet per ottenere il Get-Acl
descrittore di sicurezza per la chiave HKLM:\SOFTWARE\Microsoft\ e lo salva nella variabile.
Il secondo comando usa il ConvertFrom-SddlString
cmdlet per ottenere la rappresentazione di testo della stringa SDDL contenuta nella proprietà Sddl dell'oggetto che rappresenta il descrittore di sicurezza.
Usa il parametro per specificare che la -Type
stringa SDDL rappresenta un descrittore di sicurezza del Registro di sistema.
Esempio 3: Convertire i diritti di accesso al Registro di sistema SDDL in un PSCustomObject usando ConvertFrom-SddlString con e senza il parametro '-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)
Il primo comando usa il cmdlet per ottenere il Get-Acl
descrittore di sicurezza per la chiave HKLM:\SOFTWARE\Microsoft\ e lo salva nella variabile.
Il secondo comando usa il ConvertFrom-SddlString
cmdlet per ottenere la rappresentazione di testo della stringa SDDL contenuta nella proprietà Sddl dell'oggetto che rappresenta il descrittore di sicurezza.
Non usa il -Type
parametro, quindi i diritti di accesso visualizzati sono per il file system.
Il terzo comando usa il cmdlet con il ConvertFrom-SddlString
-Type
parametro, quindi i diritti di accesso restituiti sono per il Registro di sistema.
Esempio 4: Convertire i diritti di accesso di Active Directory SDDL in un PSCustomObject
$user = [ADSI]"LDAP://CN=username,CN=Users,DC=domain,DC=com"
ConvertFrom-SddlString $user.psbase.ObjectSecurity.Sddl -Type ActiveDirectoryRights
Il primo comando usa Active Directory Service Interfaces (ADSI) per ottenere l'oggetto utente e salvarlo nella variabile.
Il secondo comando usa il cmdlet per ottenere la ConvertFrom-SddlString
rappresentazione di testo della stringa SDDL contenuta nella proprietà Sddl dell'oggetto che rappresenta il descrittore di sicurezza.
Usa il parametro per specificare che la -Type
stringa SDDL rappresenta un descrittore di sicurezza di Active Directory.
Parametri
-Sddl
Specifica la stringa che rappresenta il descrittore di sicurezza nella sintassi SDDL.
Type: | String |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Type
Specifica il tipo di diritti rappresentato dalla stringa SDDL.
I valori validi per questo parametro sono:
- Filesystemrights
- Registryrights
- Activedirectoryrights
- Mutexrights
- Semaphorerights
- CryptoKeyRights
- Eventwaithandlerights
Per impostazione predefinita, il cmdlet usa i diritti del file system.
CryptoKeyRights e ActiveDirectoryRights non sono supportati in PowerShell Core.
Type: | Object |
Accepted values: | FileSystemRights, RegistryRights, ActiveDirectoryRights, MutexRights, SemaphoreRights, CryptoKeyRights, EventWaitHandleRights |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |