Vytvoření nebo aktualizace proměnné prostředí cesty

Description

Tento příklad ukazuje, jak můžete prostředek použít Environment k zajištění, že proměnná prostředí cesty existuje s konkrétní hodnotou.

V případě, že je nastavená možnost ,Název nastavena TestEnvironmentVariablena Presenthodnotu a HodnotaTestValuenastavena na , přidá prostředek proměnnou prostředí volanou TestEnvironmentVariable s hodnotouTestValue, pokud neexistuje.

Pokud je cesta nastavená na $true, pokud TestEnvironmentVariable existuje a neobsahuje TestValue, prostředek připojí TestValue k aktuální hodnotě.

Když je cíl nastavený na pole s oběma Process a Machine, prostředek vytvoří nebo nastaví proměnnou prostředí v rámci procesu i cíle počítače.

S Invoke-DscResource

Tento skript ukazuje, jak můžete použít Environment prostředek s rutinou Invoke-DscResource , abyste zajistili TestEnvironmentVariable , že je v procesu a cíle počítače nastavené tak, aby zahrnovaly TestValue.

[CmdletBinding()]
param()

begin {
    $SharedParameters = @{
        Name       = 'Environment'
        ModuleName = 'PSDscResource'
        Properties = @{
            Name   = 'TestPathEnvironmentVariable'
            Value  = 'TestValue'
            Ensure = 'Present'
            Path   = $true
            Target = @(
                'Process'
                'Machine'
            )
        }
    }

    $NonGetProperties = @(
        'Value'
        'Path'
        '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
    }
}

S konfigurací

Tento fragment kódu ukazuje, jak můžete definovat Configuration blok Environment prostředků, abyste zajistili TestEnvironmentVariable , že je v procesu a cílech počítače nastavené tak, aby zahrnovaly TestValue.

Configuration CreatePathVariable  {
    Import-DscResource -ModuleName 'PSDscResources'

    Node localhost {
        Environment ExampleEnvironment {
            Name   = 'TestPathEnvironmentVariable'
            Value  = 'TestValue'
            Ensure = 'Present'
            Path   = $true
            Target = @(
                'Process'
                'Machine'
            )
        }
    }
}