CommonTasks

0.5.0-preview0001

DSCResources/DscDiagnostic/DscDiagnostic.schema.psm1

function Stop-DscLocalConfigurationManager {
    #usually the process consuming the most memory is the DSC LCM
    $p = Get-Process -Name WmiPrvSE -IncludeUserName |
    Where-Object UserName -eq 'NT AUTHORITY\SYSTEM' |
    Sort-Object -Property WS -Descending |
    Select-Object -First 1

    Write-Host "The LCM is running un process with $($p.Id) consuming $([System.Math]::Round($p.WS / 1MB, 2))MB of memory (Working Set)."
    $p | Stop-Process -Force
    Write-Host 'The LCM process was killed'
}

function Get-DscConfigurationVersion {
    $key = Get-Item HKLM:\SOFTWARE\DscTagging
    $hash = @{ }
    foreach ($property in $key.Property) {
        $hash.Add($property, $key.GetValue($property))
    }

    New-Object -TypeName PSObject -Property $hash
}

function Get-DscLcmControllerSettings {
    $key = Get-Item HKLM:\SOFTWARE\DscLcmController
    $hash = @{ }
    foreach ($property in $key.Property) {
        $hash.Add($property, $key.GetValue($property))
    }

    $maintenanceWindows = Get-ChildItem -Path HKLM:\SOFTWARE\DscLcmController\MaintenanceWindows
    $maintenanceWindowsHash = @{ }
    foreach ($maintenanceWindow in $maintenanceWindows) {
        $mwHash = @{ }
        foreach ($property in $maintenanceWindow.Property) {
            $mwHash.Add($property, $maintenanceWindow.GetValue($property))
        }
        $maintenanceWindowsHash.Add($maintenanceWindow.PSChildName, $mwHash)
    }

    $hash.Add('MaintenanceWindows', (New-Object -TypeName PSObject -Property $maintenanceWindowsHash))

    New-Object -TypeName PSObject -Property $hash
}

function Test-DscConfiguration {
    PSDesiredStateConfiguration\Test-DscConfiguration -Detailed -Verbose
}
function Update-DscConfiguration {
    PSDesiredStateConfiguration\Update-DscConfiguration -Wait -Verbose
}

function Get-DscLocalConfigurationManager {
    PSDesiredStateConfiguration\Get-DscLocalConfigurationManager
}
function Get-DscLcmControllerLog {
    param (
        [Parameter()]
        [switch]$AutoCorrect,

        [Parameter()]
        [switch]$Refresh,

        [Parameter()]
        [switch]$Monitor,

        [Parameter()]
        [int]$Last = 1000
    )

    Import-Csv -Path C:\ProgramData\Dsc\LcmController\LcmControllerSummary.csv | Where-Object {
        if ($AutoCorrect) {
            [bool][int]$_.DoAutoCorrect -eq $AutoCorrect
        }
        else {
            $true
        }
    } | Where-Object {
        if ($Refresh) {
            [bool][int]$_.DoRefresh -eq $Refresh
        }
        else {
            $true
        }
    } | Where-Object {
        if ($Monitor) {
            [bool][int]$_.DoMonitor -eq $Monitor
        }
        else {
            $true
        }
    } | Microsoft.PowerShell.Utility\Select-Object -Last $Last
}

function Start-DscConfiguration {
    PSDesiredStateConfiguration\Start-DscConfiguration -UseExisting -Wait -Verbose
}

function Get-DscOperationalEventLog {
    Get-WinEvent -LogName "Microsoft-Windows-Dsc/Operational"
}

function Get-DscTraceInformation {
    param (
        [Parameter()]
        [int]$Last = 100
    )

    if (-not (Get-Module -ListAvailable -Name xDscDiagnostics)) {
        Write-Error "This function required the module 'xDscDiagnostics' to be present on the system"
        return
    }

    $failedJobs = Get-xDscOperation -Newest $Last | Where-Object Result -eq 'Failure'

    foreach ($failedJob in $failedJobs) {
        if ($failedJob.JobID) {
            Trace-xDscOperation -JobId $failedJob.JobID
        }
        else {
            Trace-xDscOperation -SequenceID $failedJob.SequenceId
        }
    }
}

#-------------------------------------------------------------------------------------------

Configuration DscDiagnostic {

    Import-DscResource -ModuleName PSDesiredStateConfiguration
    Import-DscResource -ModuleName JeaDsc

    $visibleFunctions = 'Test-DscConfiguration',
    'Get-DscConfigurationVersion',
    'Update-DscConfiguration',
    'Get-DscLcmControllerLog',
    'Start-DscConfiguration',
    'Get-DscOperationalEventLog',
    'Get-DscTraceInformation',
    'Get-DscLcmControllerSettings',
    'Get-DscLocalConfigurationManager',
    'Stop-DscLocalConfigurationManager'

    $functionDefinitions = @()
    foreach ($visibleFunction in $visibleFunctions) {
        $functionDefinitions += @{
            Name        = $visibleFunction
            ScriptBlock = (Get-Command -Name $visibleFunction).ScriptBlock
        } | ConvertTo-Expression
    }

    JeaRoleCapabilities ReadDiagnosticRole
    {
        Path                = 'C:\Program Files\WindowsPowerShell\Modules\DscDiagnostics\RoleCapabilities\ReadDiagnosticsRole.psrc'
        VisibleFunctions    = $visibleFunctions
        FunctionDefinitions = $functionDefinitions
    }

    JeaSessionConfiguration DscEndpoint
    {
        Ensure          = 'Present'
        DependsOn       = '[JeaRoleCapabilities]ReadDiagnosticRole'
        Name            = 'DSC'
        RoleDefinitions = '@{ Everyone = @{ RoleCapabilities = "ReadDiagnosticsRole" } }'
        SessionType     = 'RestrictedRemoteServer'
        ModulesToImport = 'PSDesiredStateConfiguration', 'xDscDiagnostics'
    }
}