Compartilhar via


Remover uma chave do Registro

Descrição

Este exemplo mostra como você pode usar o Registry recurso para garantir que uma chave do Registro não exista.

Com Ensure definido como Absent, ValueName definido como uma cadeia de caracteres vazia e Conjunto de chaves , HKLM:\SYSTEM\CurrentControlSet\Control\Session Manager\Environment\MyNewKeyo recurso remove a chave do MyNewKey Registro se ela existir.

Com Invoke-DscResource

Este script mostra como você pode usar o Registry recurso com o Invoke-DscResource cmdlet para garantir que a chave do MyNewKey Registro não exista.

[CmdletBinding()]
param()

begin {
    $SharedParameters = @{
        Name       = 'Registry'
        ModuleName = 'PSDscResource'
        Properties = @{
            Key       = 'HKLM:\SYSTEM\CurrentControlSet\Control\Session Manager\Environment\MyNewKey'
            Ensure    = 'Absent'
            ValueName = ''
        }
    }

    $NonGetProperties = @(
        'Ensure'
    )
}

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
    }
}

Com uma configuração

Este snippet mostra como você pode definir um com um ConfigurationRegistry bloco de recursos para garantir que a chave do MyNewKey Registro não exista.

Configuration RemoveKey {
    Import-DscResource -ModuleName 'PSDscResources'

    Node localhost {
        Registry ExampleRegistry {
            Key       = 'HKLM:\SYSTEM\CurrentControlSet\Control\Session Manager\Environment\MyNewKey'
            Ensure    = 'Absent'
            ValueName = ''
        }
    }
}