ConvertFrom-SddlString (Microsoft.PowerShell.Utility)

ConvertFrom-SddlString

Модуль:: Microsoft.PowerShell.Utility

Преобразует строку SDDL в пользовательский объект.

Синтаксис

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

Описание

Этот командлет доступен только на платформе Windows.

Командлет ConvertFrom-SddlString преобразует строку языка определения дескриптора безопасности в пользовательский объект PSCustomObject со следующими свойствами: Owner, Group, DiscretionaryAcl, SystemAcl и RawDescriptor.

Свойства Owner, Group, DiscretionaryAcl и SystemAcl содержат читаемое текстовое представление прав доступа, указанных в строке SDDL.

Этот командлет был представлен в PowerShell 5.0.

Примеры

Пример 1. Преобразование прав доступа к файловой системе SDDL в PSCustomObject.

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

Первая команда использует командлет Get-Acl, чтобы получить дескриптор безопасности для папки C:\Windows и сохранить его в переменной.

Вторая команда использует командлет ConvertFrom-SddlString для получения текстового представления строки SDDL, содержащейся в свойстве Sddl объекта, представляющего дескриптор безопасности.

Пример 2. Преобразование прав доступа к реестру SDDL в PSCustomObject.

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

Первая команда использует командлет Get-Acl для получения дескриптора безопасности для ключа 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 не используется, поэтому показаны права доступа для файловой системы.

Третья команда использует командлет ConvertFrom-SddlString с параметром -Type, поэтому возвращаемые права доступа предназначены для реестра.

Параметры

-Sddl

Указывает строку, представляющую дескриптор безопасности в синтаксисе SDDL.

Тип :: String
Позиция:: 0
Значение по умолчанию:: None
Необходимый:: True
Примите ввод конвейера:: True
Принимайте подстановочные знаки:: False

-Type

Указывает тип прав, которые представляет строка SDDL.

Допустимые значения этого параметра:

права файловой системы
RegistryRights
Активдиректорирайтс
MutexRights
SemaphoreRights
CryptoKeyRights
СобытиеWaitHandleRights

По умолчанию командлет использует права файловой системы.

CryptoKeyRights и ActiveDirectoryRights не поддерживаются в PowerShell v6 и более поздних версиях.

Тип :: Microsoft.PowerShell.Commands.ConvertFromSddlStringCommand+AccessRightTypeNames
Принятые значения:: FileSystemRights, RegistryRights, ActiveDirectoryRights, MutexRights, SemaphoreRights, CryptoKeyRights, EventWaitHandleRights
Позиция:: Именованный
Значение по умолчанию:: None
Необходимый:: False
Примите ввод конвейера:: False
Принимайте подстановочные знаки:: False

Входы

Строка

В этот командлет можно передать строку SDDL.

Примечания

Этот командлет доступен только на платформах Windows.