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

Invoke-DscResource

  • Ссылка
Модуль:
PSDesiredStateConfiguration

Запускает метод указанного ресурса DSC.

Синтаксис

Invoke-DscResource
      [-Name] <String>
      [-Method] <String>
      -ModuleName <ModuleSpecification>
      -Property <Hashtable>
      [<CommonParameters>]

Описание

Командлет Invoke-DscResource выполняет метод указанного ресурса Windows PowerShell Desired State Configuration (DSC). Перед выполнением этого командлета установите режим обновления локального Configuration Manager (LCM) в значение Отключено.

Этот командлет вызывает ресурс DSC напрямую, не создавая документ конфигурации. С помощью этого командлета продукты управления конфигурацией могут управлять окнами с помощью ресурсов DSC. Этот командлет также включает отладку ресурсов, если подсистема DSC или LCM запущены с включенной отладкой.

Этот командлет не работает с составными ресурсами. Составные ресурсы являются параметризованными конфигурациями. Для использования составных ресурсов требуется LCM.

Примеры

Пример 1. Вызов метода Set ресурса путем указания его обязательных свойств

Invoke-DscResource -Name Log -Method Set -Property @{Message = 'Hello World'} -ModuleName PSDesiredStateConfiguration

Эта команда вызывает метод Set ресурса с именем Log и задает для него свойство Message .

Пример 2. Вызов метода Test ресурса для указанного модуля

Invoke-DscResource -Name WindowsProcess -Method Test -Property @{Path = 'C:\Windows\System32\WindowsPowerShell\v1.0\powershell.exe'; Arguments = ''} -ModuleName PSDesiredStateConfiguration

Эта команда вызывает метод Test ресурса с именем WindowsProcess, который находится в модуле PSDesiredStateConfiguration.

Параметры

-Method

Указывает метод ресурса, вызываемого этим командлетом. Допустимые значения для этого параметра:

  • Get
  • Set
  • Test
Type:String
Accepted values:Get, Set, Test
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ModuleName

Указывает имя модуля, из которого этот командлет вызывает указанный ресурс.

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

-Name

Указывает имя запускаемого ресурса DSC.

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

-Property

Указывает имя свойства ресурса и его значение в хэш-таблице как ключ и значение соответственно. Get-DscResource Используйте командлет для обнаружения свойств ресурсов и их типов.

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

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

Microsoft.Management.Infrastructure.CimInstance, System.Boolean