Dodawanie lub aktualizowanie wartości klucza rejestru

Opis

W tym przykładzie pokazano, jak można użyć Registry zasobu, aby upewnić się, że ustawiono wartość klucza rejestru.

W przypadku ustawienia PresentUpewnij się, wartość ValueName ustawiona na MyValuewartość , a wartość Klucz jest ustawiona na HKLM:\SYSTEM\CurrentControlSet\Control\Session Manager\Environment, zasób dodaje MyValue wartość klucza rejestru w kluczuEnvironment, jeśli nie istnieje.

W przypadku wartości ValueType ustawionej na Binary0x00wartość valueData ustawiono wartość , a wymuś ustawienie na $truewartość , zasób ustawia wartość klucza rejestru na 0 wartość , nawet jeśli istnieje z inną wartością.

Z Invoke-DscResource

Ten skrypt pokazuje, jak można użyć Registry zasobu z Invoke-DscResource poleceniem cmdlet , aby upewnić się, że Environment klucz rejestru ma wartość ustawioną MyValue na 0.

[CmdletBinding()]
param()

begin {
    $SharedParameters = @{
        Name       = 'Registry'
        ModuleName = 'PSDscResource'
        Properties = @{
            Key       = 'HKLM:\SYSTEM\CurrentControlSet\Control\Session Manager\Environment'
            Ensure    = 'Present'
            ValueName = 'MyValue'
            ValueType = 'Binary'
            ValueData = '0x00'
            Force     = $true
        }
    }

    $NonGetProperties = @(
        'Ensure'
        'ValueType'
        'ValueData'
        'Force'
    )
}

process {
    $TestResult = Invoke-DscResource -Method Test @SharedParameters

    if ($TestResult.InDesiredState) {
        $QueryParameters = $SharedParameters.Clone()

        foreach ($Property in $NonGetProperties) {
            $QueryParameters.Properties.Remove($Property)
        }

        Invoke-DscResource -Method Get @QueryParameters
    } else {
        Invoke-DscResource -Method Set @SharedParameters
    }
}

Z konfiguracją

Ten fragment kodu pokazuje, jak można zdefiniować Configuration element z blokiem Registry zasobów, aby upewnić się, że Environment klucz rejestru ma wartość ustawioną MyValue na 0.

Configuration AddOrModifyValue {
    Import-DscResource -ModuleName 'PSDscResources'

    Node localhost {
        Registry ExampleRegistry {
            Key       = 'HKLM:\SYSTEM\CurrentControlSet\Control\Session Manager\Environment'
            Ensure    = 'Present'
            ValueName = 'MyValue'
            ValueType = 'Binary'
            ValueData = '0x00'
            Force     = $true
        }
    }
}