Поделиться через


Get-DscResource

Возвращает Desired State Configuration ресурсов (DSC), присутствующих на компьютере.

Синтаксис

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*

Эта команда получает все ресурсы, соответствующие шаблону подстановочных знаков, заданному параметром Name .

Пример 5. Получение синтаксиса ресурса

Get-DscResource -Name "WindowsFeature" -Syntax

Эта команда возвращает ресурс WindowsFeature и отображает синтаксис для ресурса.

Пример 6. Получение всех свойств ресурса

Get-DscResource -Name "User" | Select-Object -ExpandProperty Properties

Эта команда возвращает ресурс пользователя, а затем использует оператор конвейера для возврата всех свойств для ресурса пользователя.

Пример 7. Получение всех ресурсов из указанного модуля с указанной версией

Get-DscResource -Module @{ModuleName='xHyper-V';RequiredVersion='3.0.0.0'}

Эта команда получает все ресурсы из модуля xHyper-V версии 3.0.0.0.

Параметры

-Module

Указывает имя или полное имя модуля, для которого нужно просмотреть ресурс DSC.

Type:Object
Position:1
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Name

Задает массив имен ресурса DSC для просмотра.

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

-Syntax

Указывает, что командлет возвращает представление синтаксиса для указанных ресурсов DSC. Возвращенный синтаксис показывает, как использовать ресурсы в скрипте PowerShell.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Входные данные

String[]

Object

Выходные данные

Microsoft.PowerShell.DesiredStateConfiguration.DscResourceInfo[]

string[]