Share via


DSC för Linux nxEnvironment-resurs

NxEnvironment-resursen i PowerShell Desired State Configuration (DSC) tillhandahåller en mekanism för att hantera systemmiljövariabler på en Linux-nod.

Syntax

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

Egenskaper

Egenskap Beskrivning
Name Anger namnet på miljövariabeln som du vill säkerställa ett visst tillstånd för.
Värde Värdet som ska tilldelas till miljövariabeln.
Sökväg Definierar miljövariabeln som konfigureras. Ange den här egenskapen till $true om variabeln är variabeln Sökväg . Annars anger du den till $false. Standardvärdet är $false. Om variabeln som konfigureras är variabeln Sökväg läggs värdet som tillhandahålls via egenskapen Value till det befintliga värdet.

Gemensamma egenskaper

Egenskap Beskrivning
DependsOn Anger att konfigurationen av en annan resurs måste köras innan den här resursen har konfigurerats. Om till exempel ID:t för det resurskonfigurationsskriptblock som du vill köra först är ResourceName och dess typ är ResourceType är DependsOn = "[ResourceType]ResourceName"syntaxen för att använda den här egenskapen .
Säkerställa Avgör om variabeln finns. Ställ in den här egenskapen på Presentera för att säkerställa att variabeln finns. Ställ in den på Frånvarande för att säkerställa att variabeln inte finns. Standardvärdet är Present.

Ytterligare information

  • Om Sökvägen är frånvarande eller inställd på $falsehanteras miljövariabler i /etc/environment. Dina program eller skript kan kräva konfiguration för att hämta /etc/environment filen för att få åtkomst till variablerna i den hanterade miljön.
  • Om Sökväg är inställd på $truehanteras miljövariabeln i filen /etc/profile.d/DSCenvironment.sh. Den här filen skapas om den inte finns. Om Se till är inställt på Frånvarande och Sökväg har angetts till $truetas endast en befintlig miljövariabel bort från /etc/profile.d/DSCenvironment.sh och inte från andra filer.

Exempel

I följande exempel visas hur du använder nxEnvironment-resursen för att säkerställa att TestEnvironmentVariable finns och har värdet "Test-Value". Om TestEnvironmentVariable inte finns skapas det.

Import-DSCResource -ModuleName nx

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