建立或更新路徑環境變數

描述

此範例示範如何使用 Environment 資源來確保路徑環境變數存在具有特定值。

將[確定] 設定為 、[名稱] 設定為 TestEnvironmentVariablePresent ，並將 [值] 設定為 TestValue ，如果資源不存在，則會新增名為 TestEnvironmentVariable 的 TestValue 環境變數。

如果 Path 設定為 $true ，如果 TestEnvironmentVariable 存在且不包含 TestValue ，則資源會附加 TestValue 至目前的值。

將 Target 設定為同時具有 Process 和 Machine 的陣列時，資源會在進程和電腦目標中建立或設定環境變數。

使用 Invoke-DscResource

此腳本示範如何搭配 Cmdlet 使用 Environment 資源，以確保 TestEnvironmentVariable 已設定于進程和電腦目標中，以包含 TestValue 。 Invoke-DscResource

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

使用組態

此程式碼片段示範如何使用資源區塊來定義 ， ConfigurationEnvironment 以確保 TestEnvironmentVariable 會在進程和電腦目標中設定，以包含 TestValue 。

Configuration CreatePathVariable  {
    Import-DscResource -ModuleName 'PSDscResources'

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