При создании DSC-конфигурации мы используем ресурсы. Каждый ресурс обладает определенным набором свойств, значения которых определяют, что будет из себя представлять результат применения данной конфигурации.
Для получения всех ресурсов, доступных нам локально, мы можем воспользоваться командлетом:
Get-DSCResource
Для поиска ресурсов в PowerShell Gallery нам потребуется командлет:
Find-DSCResource
Если мы хотим получить сведения только о DSC-ресурсах, входящих DSC Resource Kit, представляющий из себя коллекцию DSC-ресурсов, поддерживаемую Microsoft, то нам пригодится следующая команда:
Find-DscResource -Tag DSCResourceKit
Установить модуль с нужными нам ресурсами из PowerShell Gallery мы можем при помощи командлета:
Install-Module
Но вернемся к локальным ресурсам. К примеру, нас заинтересовал ресурс File. Для получения всех его свойств мы можем ввести команду:
Get-DscResource -Name File | Select-Object -ExpandProperty Properties
Более коротким вариантом будет:
Get-DscResource File | % Properties
Результатом выполнения этих команд будет таблица, содержащая имена свойств, поддерживаемые типы данных, указание, является ли определенное свойство обязательным, и список возможных значений для тех свойств, что ограничены определенным набором.
Также, получить список возможных свойств ресурса можно при помощи команды:
Get-DscResource -Name File -Syntax
Результат выполнения командлета Get-DSCResource с параметром -Syntax кроме всего прочего полезен еще и тем, что его можно вставить в конфигурацию и уже там привести к нужному виду.
И конечно, мы можем получить информацию о свойствах ресурса при помощи сочетания клавиш Ctrl + Space в PowerShell ISE и Visual Studio Code.
Страницы в социальных сетях:
Twitter: https://twitter.com/vsseth
Facebook: https://fb.com/inpowershell
VKontakte: https://vk.com/inpowershell