DSC dla systemu Linux nxEnvironment Resource

  • Artykuł

Zasób nxEnvironment w programie PowerShell Desired State Configuration (DSC) udostępnia mechanizm zarządzania zmiennymi środowiskowymi systemu w węźle systemu Linux.

Składnia

nxEnvironment <string> #ResourceName
{
    Name = <string>
    [ Value = <string>
    [ Path = <bool> }
    [ DependsOn = <string[]> ]
    [ Ensure = <string> { Absent | Present }  ]
}

Właściwości

Właściwość Opis
Nazwa Wskazuje nazwę zmiennej środowiskowej, dla której chcesz zapewnić określony stan.
Wartość Wartość do przypisania do zmiennej środowiskowej.
Ścieżka Definiuje zmienną środowiskową, która jest konfigurowana. Ustaw tę właściwość na $true wartość , jeśli zmienna jest zmienną Path . W przeciwnym razie ustaw ją na $false. Wartość domyślna to $false. Jeśli skonfigurowana zmienna jest zmienną Path , wartość podana za pomocą właściwości Value zostanie dołączona do istniejącej wartości.

Wspólne właściwości

Właściwość Opis
Dependson Wskazuje, że konfiguracja innego zasobu musi zostać uruchomiona przed skonfigurowaniem tego zasobu. Jeśli na przykład identyfikator bloku skryptu konfiguracji zasobu, który chcesz uruchomić jako pierwszy, to ResourceName, a jego typ to ResourceType, składnia użycia tej właściwości to DependsOn = "[ResourceType]ResourceName".
Zapewnienia Określa, czy zmienna istnieje. Ustaw tę właściwość na Wartość Obecna , aby upewnić się, że zmienna istnieje. Ustaw wartość Brak , aby upewnić się, że zmienna nie istnieje. Wartość domyślna to Obecny.

Dodatkowe informacje

  • Jeśli ścieżka jest nieobecna lub ustawiona na $false, zmienne środowiskowe są zarządzane w programie /etc/environment. Programy lub skrypty mogą wymagać konfiguracji w celu uzyskania /etc/environment dostępu do zarządzanych zmiennych środowiskowych.
  • Jeśli ścieżka jest ustawiona na $true, zmienna środowiskowa jest zarządzana w pliku /etc/profile.d/DSCenvironment.sh. Ten plik zostanie utworzony, jeśli nie istnieje. Jeśli ustawienie Upewnij się , że ustawiono wartość Brak , a ścieżka jest ustawiona na $truewartość , istniejąca zmienna środowiskowa zostanie usunięta tylko z /etc/profile.d/DSCenvironment.sh innych plików, a nie z innych plików.

Przykład

W poniższym przykładzie pokazano, jak użyć zasobu nxEnvironment , aby upewnić się, że element TestEnvironmentVariable jest obecny i ma wartość "Test-Value". Jeśli element TestEnvironmentVariable nie jest obecny, zostanie utworzony.

Import-DSCResource -ModuleName nx

nxEnvironment EnvironmentExample
{
    Ensure = "Present"
    Name = "TestEnvironmentVariable"
    Value = "TestValue"
}