Desired State Configuration (DSC) basics in PowerShell - Step-by-Step Execution

Concept Flow - Desired State Configuration (DSC) basics

Write DSC Configuration Script

↓

Compile Configuration -> MOF File

↓

Apply MOF to Target Node

↓

DSC Agent Checks Current State

↓

Compare Current State with Desired State

↓

Do Nothing

↓

Report Success

DSC runs by writing a configuration script, compiling it to a MOF file, then applying it to a target node where the DSC agent ensures the system matches the desired state.

Execution Sample

PowerShell

Configuration SampleConfig {
  Node localhost {
    File ExampleFile {
      DestinationPath = 'C:\\example.txt'
      Contents = 'Hello DSC!'
      Ensure = 'Present'
    }
  }
}

SampleConfig
Start-DscConfiguration -Path .\SampleConfig -Wait -Verbose

This script defines a DSC configuration to create a file with specific content and applies it to the local machine.

Execution Table

Step	Action	Evaluation	Result
1	Define Configuration SampleConfig	Script parsed	Configuration block created
2	Compile SampleConfig	MOF file generated	SampleConfig.mof created
3	Start-DscConfiguration with MOF path	DSC agent reads MOF	DSC agent starts applying configuration
4	Check if 'C:\example.txt' exists with content 'Hello DSC!'	File missing or content different	File created with correct content
5	Verify file state	File exists with correct content	DSC reports success
6	End	No further actions	Configuration applied successfully

💡 DSC stops after confirming the system matches the desired state defined in the MOF file.

Variable Tracker

Variable	Start	After Step 2	After Step 3	After Step 4	Final
Configuration Script	Not defined	Defined	Defined	Defined	Defined
MOF File	Not created	Created	Created	Created	Created
DSC Agent State	Idle	Idle	Applying	Applying	Idle
File 'C:\example.txt'	Does not exist	Does not exist	Does not exist	Created with content	Exists with content

Key Moments - 3 Insights

Why does DSC create a MOF file before applying configuration?

The MOF file is a compiled version of the configuration script that the DSC agent reads to know the desired state. This is shown in execution_table step 2 where the MOF file is generated before applying.

What happens if the file already exists with the correct content?

DSC detects the current state matches the desired state and does nothing, as seen in execution_table step 4 where the check would find the file present and skip creation.

Why does DSC report success after applying changes?

Because after making changes, DSC verifies the system matches the desired state, confirming success as shown in execution_table step 5.

Visual Quiz - 3 Questions

Look at the execution_table, what is the result of step 4?

A MOF file generated

B File created with correct content

C DSC agent starts applying configuration

D No further actions

💡 Hint

Check the 'Result' column in step 4 of the execution_table.

At which step does the DSC agent begin applying the configuration?

A Step 3

B Step 5

C Step 2

D Step 1

💡 Hint

Look at the 'Action' and 'Result' columns to find when the DSC agent starts.

If the file already exists with the correct content, what would change in the execution_table?

A Step 4 would show 'File created with correct content'

B Step 4 would show 'File missing or content different'

C Step 4 would show 'File exists with correct content' and no creation action

D Step 5 would be skipped

💡 Hint

Refer to the key_moments explanation about existing file state and step 4.

Concept Snapshot

Desired State Configuration (DSC) basics:
- Write a configuration script defining desired state.
- Compile script to MOF file.
- Apply MOF to target node.
- DSC agent compares current vs desired state.
- Makes changes if needed, then reports success.
- Ensures system stays in desired state automatically.

Full Transcript

Desired State Configuration (DSC) is a way to make sure a computer system stays in a specific setup you want. First, you write a configuration script that says what you want, like creating a file with certain content. Then, you compile this script into a MOF file, which is like a set of instructions. You apply this MOF file to the computer, and the DSC agent on that computer reads it. The agent checks if the current system matches what you want. If not, it fixes things, like creating the file. Once everything matches, DSC reports success and keeps the system in that state. This process helps keep computers consistent and saves time from fixing things manually.