Desired State Configuration

Configuration Demo { Node localhost { File Marker { DestinationPath="C:\Demo\marker.txt";Contents="ok";Ensure="Present" } } }
Demo -OutputPath .\mof

Configuration Demo {
    param([pscredential]$Credential)
    Node localhost {
        # Ресурс использует Credential только во время компиляции конфигурации.
    }
}

$configData=@{AllNodes=@(@{NodeName="srv1";Role="Web"})}
$valueType = if($null -eq $configData){'<null>'}else{$configData.GetType().FullName}
[pscustomobject]@{ Value=$configData; Type=$valueType; Count=@($configData).Count }

[DscResource()] class AppFile {
  [DscProperty(Key)][string]$Path
  [DscProperty(Mandatory)][string]$Content
  [AppFile] Get(){ $r=[AppFile]::new(); $r.Path=$this.Path; $r.Content=Get-Content $this.Path -Raw; return $r }
  [bool] Test(){ return (Test-Path $this.Path) -and ((Get-Content $this.Path -Raw) -eq $this.Content) }
  [void] Set(){ Set-Content -LiteralPath $this.Path -Value $this.Content }
}

$result = & { File DataDir { DestinationPath="C:\Data";Type="Directory";Ensure="Present" } }
$resultType = if($null -eq $result){'<null>'}else{$result.GetType().FullName}
[pscustomobject]@{ Result=$result; Type=$resultType; Count=@($result).Count }

$result = & { Service DemoSvc { Name="Demo";State="Running";DependsOn="[File]Config" } }
$resultType = if($null -eq $result){'<null>'}else{$result.GetType().FullName}
[pscustomobject]@{ Result=$result; Type=$resultType; Count=@($result).Count }

if(-not (Test-TargetResource @p)){Set-TargetResource @p}
Test-TargetResource @p

$result = Contents="Generated at $(Get-Date)"
$summary = [ordered]@{ IsNull=($null -eq $result); Count=@($result).Count }
if($null -ne $result){$summary.Type=$result.GetType().FullName};[pscustomobject]$summary

$result = Compare-Object ($desired|Sort-Object) ($actual|Sort-Object)
$items = @($result)
[pscustomobject]@{ Count=$items.Count; First=$items | Select-Object -First 1; IsNull=($null -eq $result) }

$result = Test-DscConfiguration -Detailed
$items = @($result)
[pscustomobject]@{ Count=$items.Count; First=$items | Select-Object -First 1; IsNull=($null -eq $result) }

$result = Get-DscLocalConfigurationManager | Select-Object ConfigurationMode,RefreshMode
$summary = [ordered]@{ IsNull=($null -eq $result); Count=@($result).Count }
if($null -ne $result){$summary.Type=$result.GetType().FullName};[pscustomobject]$summary

$result = Get-DscConfigurationStatus -All | Select-Object StartDate,Status,Type
$shape = if($null -eq $result){'<null>'}elseif($result -is [array]){'array'}else{$result.GetType().Name}
[pscustomobject]@{ Shape=$shape; Values=@($result) }

$result = Get-WinEvent -LogName Microsoft-Windows-DSC/Operational -MaxEvents 50
$items = @($result)
[pscustomobject]@{ Count=$items.Count; First=$items | Select-Object -First 1; IsNull=($null -eq $result) }

$result = Get-DscConfiguration | Format-List *
$items = @($result)
[pscustomobject]@{ Count=$items.Count; First=$items | Select-Object -First 1; IsNull=($null -eq $result) }

# Сценарий для ревью: Ресурс завис на Set.
$status = Get-DscConfigurationStatus -All | Select-Object -First 5 StartDate,Type,Status,Error
$lcm = Get-DscLocalConfigurationManager
[pscustomobject]@{ Mode=$lcm.ConfigurationMode; Frequency=$lcm.ConfigurationModeFrequencyMins; Status=$status }
$status | Export-Clixml .\dsc-status.clixml

# Сценарий для ревью: MOF содержит credential.
$context = [pscustomobject]@{ User=[Environment]::UserName; Host=$Host.Name; At=[datetimeoffset]::UtcNow }
$headers = @{ Authorization = "Bearer $env:API_TOKEN" }
Write-Information (ConvertTo-Json @{ Context=$context; Headers=$headers }) -InformationAction Continue
Invoke-RestMethod -Uri $uri -Headers $headers -ErrorAction Stop

# Сценарий для ревью: Pull server выдаёт конфигурации без строгой аутентификации.
$status = Get-DscConfigurationStatus -All | Select-Object -First 5 StartDate,Type,Status,Error
$lcm = Get-DscLocalConfigurationManager
[pscustomobject]@{ Mode=$lcm.ConfigurationMode; Frequency=$lcm.ConfigurationModeFrequencyMins; Status=$status }
$status | Export-Clixml .\dsc-status.clixml

# Сценарий для ревью: Ресурс автоматически исправляет критичный сервер во время инцидента.
$status = Get-DscConfigurationStatus -All | Select-Object -First 5 StartDate,Type,Status,Error
$lcm = Get-DscLocalConfigurationManager
[pscustomobject]@{ Mode=$lcm.ConfigurationMode; Frequency=$lcm.ConfigurationModeFrequencyMins; Status=$status }
$status | Export-Clixml .\dsc-status.clixml