DSC für Linux-Resource „nxEnvironment“
Die Ressource nxEnvironment in PowerShell DSC (Desired State Configuration) bietet einen Mechanismus zum Verwalten von Systemumgebungsvariablen auf einem Linux-Knoten.
Syntax
nxEnvironment <string> #ResourceName
{
Name = <string>
[ Value = <string>
[ Path = <bool> }
[ DependsOn = <string[]> ]
[ Ensure = <string> { Absent | Present } ]
}
Eigenschaften
Eigenschaft | Beschreibung |
---|---|
Name | Gibt den Namen der Umgebungsvariablen an, für die Sie einen bestimmten Zustand sicherstellen möchten. |
Wert | Der Wert, der der Umgebungsvariablen zugewiesen werden soll. |
`Path` | Definiert die Umgebungsvariable, die konfiguriert wird. Legen Sie diese Eigenschaft auf $true fest, wenn die Variable die Path-Variable ist. Legen Sie sie andernfalls auf $false fest. Der Standardwert lautet $false . Wenn die konfigurierte Variable die Path-Variable ist, wird der von der Value-Eigenschaft bereitgestellte Wert an den vorhandenen Wert angefügt. |
Allgemeine Eigenschaften
Eigenschaft | BESCHREIBUNG |
---|---|
DependsOn | Gibt an, dass die Konfiguration einer anderen Ressource ausgeführt werden muss, bevor diese Ressource konfiguriert wird. Wenn beispielsweise die ID des Skriptblocks mit der Ressourcenkonfiguration, den Sie zuerst ausführen möchten, „ResourceName“ und dessen Typ „ResourceType“ ist, lautet die Syntax für das Verwenden dieser Eigenschaft DependsOn = "[ResourceType]ResourceName" . |
Ensure | Bestimmt, ob das Vorhandensein der Variablen geprüft werden soll. Legen Sie diese Eigenschaft auf Present fest, um sicherzustellen, dass die Variable vorhanden ist. Legen Sie sie auf Absent fest, um sicherzustellen, dass die Variable nicht vorhanden ist. Der Standardwert ist Present. |
Zusätzliche Informationen
- Wenn Path fehlt oder auf
$false
festgelegt ist, werden Umgebungsvariablen in/etc/environment
verwaltet. Ihre Programme oder Skripts erfordern möglicherweise das Konfigurieren des Abrufs der Datei/etc/environment
für den Zugriff auf die verwalteten Umgebungsvariablen. - Wenn Path auf
$true
festgelegt ist, wird die Umgebungsvariable in der Datei/etc/profile.d/DSCenvironment.sh
verwaltet. Falls sie noch nicht vorhanden ist, wird die Datei erstellt. Wenn Ensure auf Absent und Path auf$true
festgelegt ist, wird eine vorhandene Umgebungsvariable nur aus/etc/profile.d/DSCenvironment.sh
und nicht aus anderen Dateien entfernt.
Beispiel
Das folgende Beispiel veranschaulicht das Verwenden der Ressource nxEnvironment zum Sicherstellen, dass TestEnvironmentVariable vorhanden ist und den Wert „Test-Value“ hat. Wenn TestEnvironmentVariable nicht vorhanden ist, wird die Variable erstellt.
Import-DSCResource -ModuleName nx
nxEnvironment EnvironmentExample
{
Ensure = "Present"
Name = "TestEnvironmentVariable"
Value = "TestValue"
}
Zusammenarbeit auf GitHub
Die Quelle für diesen Inhalt finden Sie auf GitHub, wo Sie auch Issues und Pull Requests erstellen und überprüfen können. Weitere Informationen finden Sie in unserem Leitfaden für Mitwirkende.