Skip to content

SwitchLcmMode.adoc

Latest commit

 

History

History
69 lines (52 loc) · 1.73 KB

SwitchLcmMode.adoc

File metadata and controls

69 lines (52 loc) · 1.73 KB

DSC Resource 'SwitchLcmMode'

SwitchLcmMode switches the DSC Local Configuration Manager between Push and Pull modes by updating meta-configuration.

When to use 'SwitchLcmMode'

Use this resource when you need to transition a node from Push mode to Pull mode (or vice versa) by downloading and applying a new MetaMOF. This is used in scenarios where nodes start in Push mode for initial configuration and then switch to Pull mode for ongoing management.

The SwitchLcmMode resource shall be the last step in the DSC configuration otherwise the following steps are not executed.

Source

DSC Resource

Documentation
Table 1. Attributes of category 'SwitchLcmMode'
Parameter Attribute DataType Description Allowed Values

SourceMetaMofDir

Mandatory

String

Folder with the MetaMOF files

ConfigurationName

String

Name of the new configuration

A file named <ConfigurationName>.meta.mof must exist at SourceMetaMofDir.

Default: current computer name

TargetMetaMofDir

String

Target folder for the new MetaMOF file and helper scripts

Default: $env:TEMP\DSC_Config
Example
SwitchLcmMode:
  SourceMetaMofDir: \\PullServer\Config$\MetaMOF
  TargetMetaMofDir: C:\Temp\DSC
  ConfigurationName: NewConfigName  # leave this field empty to use the current computer name