Get-DscResource
Возвращает ресурсы требуемой конфигурации состояния (DSC), присутствующих на компьютере.
Синтаксис
Default (по умолчанию)
Get-DscResource
[[-Name] <String[]>]
[[-Module] <Object>]
[-Syntax]
[<CommonParameters>]
Описание
Командлет Get-DscResource извлекает ресурсы PowerShell DSC, присутствующих на компьютере. Этот командлет обнаруживает только ресурсы, установленные в PSModulePath. В нем отображаются сведения о встроенных и настраиваемых поставщиках, созданных пользователем. Этот командлет также содержит сведения о составных ресурсах, которые являются другими конфигурациями, которые упаковываются в виде модуля или создаются во время выполнения в сеансе.
Примеры
Пример 1. Получение всех ресурсов на локальном компьютере
Get-DscResource
Эта команда получает все ресурсы на локальном компьютере.
Пример 2. Получение ресурса путем указания имени
Get-DscResource -Name "WindowsFeature"
Эта команда получает ресурс WindowsFeature.
Пример 3. Получение всех ресурсов из модуля
Get-DscResource -Module "xHyper-V"
Эта команда получает все ресурсы из модуля xHyper-V.
Пример 4. Получение ресурса с помощью подстановочных знаков
Get-DscResource -Name P*,r*
Эта команда получает все ресурсы, соответствующие шаблону подстановочного знака, заданному параметром имени
Пример 5. Получение синтаксиса ресурсов
Get-DscResource -Name "WindowsFeature" -Syntax
Эта команда получает ресурс WindowsFeature и отображает синтаксис ресурса.
Пример 6. Получение всех свойств ресурса
Get-DscResource -Name "User" | Select-Object -ExpandProperty Properties
Эта команда получает ресурс User, а затем использует оператор конвейера для возврата всех свойств ресурса User.
Пример 7. Получение всех ресурсов из указанного модуля с указанной версией
Get-DscResource -Module @{ModuleName='xHyper-V';RequiredVersion='3.0.0.0'}
Эта команда получает все ресурсы из модуля xHyper-V с версией 3.0.0.0.
Параметры
-Module
Указывает имя или полное имя модуля, для которого можно просмотреть ресурс DSC.
Свойства параметра
| Тип: | Object |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | 1 |
| Обязательно: | False |
| Значение из конвейера: | True |
| Значение из конвейера по имени свойства: | True |
| Значение из оставшихся аргументов: | False |
-Name
Задает массив имен ресурса DSC для просмотра.
Свойства параметра
| Тип: | String[] |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | 0 |
| Обязательно: | False |
| Значение из конвейера: | True |
| Значение из конвейера по имени свойства: | True |
| Значение из оставшихся аргументов: | False |
-Syntax
Указывает, что командлет возвращает представление синтаксиса указанных ресурсов DSC. Возвращаемый синтаксис показывает, как использовать ресурсы в скрипте PowerShell.
Свойства параметра
| Тип: | SwitchParameter |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
CommonParameters
Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters.
