Prostředí

  • Článek

Synopse

Správa proměnné prostředí pro počítač nebo proces

Syntax

Environment [String] #ResourceName
{
    Name = [string]
    [DependsOn = [string[]]]
    [Ensure = [string]{ Absent | Present }]
    [Path = [bool]]
    [PsDscRunAsCredential = [PSCredential]]
    [Target = [string[]]{ Machine | Process }]
    [Value = [string]]
}

Description

Prostředek Environment umožňuje vytvářet, aktualizovat a odebírat proměnné prostředí v objektech Machine a Process cílech. Může spravovat proměnné prostředí typu cesta a zajistit, aby byla určitá hodnota zahrnuta nebo odebrána z proměnné prostředí.

Požadavky

Žádné

Základní vlastnosti

Name

Zadejte název proměnné prostředí.

Type: System.String

Volitelné vlastnosti

Zajištění

Určete, jestli má proměnná prostředí existovat. Tuto vlastnost zadejte, pokud Absent chcete odebrat proměnnou prostředí, pokud existuje. Tuto vlastnost zadejte tak, aby Present se vytvořila proměnná prostředí, pokud neexistuje, a vynucujte vlastnost Value , pokud je nastavená. Výchozí hodnota je Present.

Type: System.String
Accepted Values:
  - Absent
  - Present
Default Value: Present

Cesta

Určete, zda má být proměnná prostředí považována za proměnnou cesty. Tím se upraví chování zajistit pro proměnnou prostředí:

  • Pokud je $truecesta , ujistěte se, že Presenthodnota není zahrnuta do aktuální hodnoty proměnné prostředí, prostředek připojí hodnotu k aktuální hodnotě proměnné prostředí.
  • Pokud je $truecesta , ujistěte se, že je Absenta hodnota je zahrnuta do aktuální hodnoty proměnné prostředí, prostředek odebere hodnotu z aktuální hodnoty proměnné prostředí.
  • Pokud je $falsecesta a ujistětePresentse, prostředek nastaví proměnnou prostředí na Hodnotu.
  • Pokud je $falsecesta a ujistěteAbsentse, prostředek odebere proměnnou prostředí.

Výchozí hodnota je $false.

Type: System.Boolean
Default Value: false

Cíl

Zadejte jeden nebo více cílů pro konfiguraci proměnné prostředí. Platné hodnoty zahrnují:

  • Process
  • Machine

Ve výchozím nastavení je proměnná prostředí nakonfigurovaná jak v cílech Process , tak Machine i v cílech.

Type: System.String[]
Accepted Values:
  - Process
  - Machine
Default Value: [Process, Machine]

Hodnota

Zadejte hodnotu proměnné prostředí jako řetězec. Určuje, zda hodnota je prázdný řetězec ('') upraví chování pro proměnnou prostředí:

  • Pokud je hodnota prázdný řetězec, ujistěte se, že je Presenta proměnná prostředí existuje, prostředek neaktualizuje proměnnou prostředí.
  • Pokud je hodnota prázdný řetězec, ujistěte se, že je Presenta proměnná prostředí neexistuje, prostředek vyvolá neplatnou výjimku operace.
  • Pokud je hodnota prázdný řetězec, ujistěte se, že je Absenta proměnná prostředí existuje, prostředek odebere proměnnou prostředí.

Výchozí hodnota je prázdný řetězec.

Type: System.String
Default Value: ''

Příklady