about_Environment_Variables

Krátký popis

Popisuje, jak v PowerShellu přistupovat k proměnným prostředí a spravovat je.

Dlouhý popis

Proměnné prostředí ukládají data, která používají operační systém a další programy. PowerShell vytvoří následující proměnné prostředí:

PSExecutionPolicyPreference
PSModulePath
PSModuleAnalysisCachePath
PSDisableModuleAnalysisCacheCleanup

Úplný popis těchto proměnných najdete v proměnných prostředí PowerShellu v tomto článku.

PowerShell může přistupovat k proměnným prostředí a spravovat je v libovolné z podporovaných platforem operačního systému. Zprostředkovatel prostředí PowerShell umožňuje získat, přidat, změnit, vymazat a odstranit proměnné prostředí v aktuální konzole.

Proměnné prostředí, na rozdíl od jiných typů proměnných v PowerShellu, se vždy ukládají jako řetězce. Na rozdíl od jiných proměnných jsou zděděné podřízenými procesy, jako jsou místní úlohy na pozadí a relace, ve kterých členové modulu běží. Díky tomu jsou proměnné prostředí vhodné pro ukládání hodnot potřebných v nadřazených i podřízených procesech.

Ve Windows lze proměnné prostředí definovat ve třech oborech:

Rozsah počítače (nebo systému)
Obor uživatele
Rozsah procesu

Obor Proces obsahuje proměnné prostředí dostupné v aktuálním procesu nebo relaci PowerShellu. Tento seznam proměnných je zděděný z nadřazeného procesu a je vytvořen z proměnných v oborech počítače a uživatele .

Když v PowerShellu změníte proměnné prostředí, ovlivní tato změna pouze aktuální relaci. Toto chování se podobá chování příkazu set v příkazovém prostředí systému Windows a setenv příkazu v prostředích se systémem Unix. Chcete-li změnit hodnoty v oboru počítače nebo uživatele, je nutné použít metody Třídy System.Environment .

Pokud chcete provádět změny proměnných v oboru počítače, musíte mít také oprávnění. Pokud se pokusíte změnit hodnotu bez dostatečného oprávnění, příkaz selže a PowerShell zobrazí chybu.

PowerShell nabízí několik různých metod pro použití a správu proměnných prostředí.

Syntaxe proměnné
Rutiny zprostředkovatele prostředí a položky
Třída .NET System.Environment

Použití syntaxe proměnné

Hodnoty proměnných prostředí můžete zobrazit a změnit pomocí následující syntaxe:

$Env:<variable-name>

Pokud například chcete zobrazit hodnotu windir proměnné prostředí:

$Env:windir

C:\Windows

V této syntaxi znak dolaru ($) označuje proměnnou a název jednotky (Env:) označuje proměnnou prostředí následovanou názvem proměnné (windir).

Hodnotu proměnných prostředí můžete vytvořit a aktualizovat pomocí následující syntaxe:

$Env:<variable-name> = "<new-value>"

Pokud chcete například vytvořit proměnnou Foo prostředí:

$Env:Foo = 'An example'

Vzhledem k tomu, že proměnné prostředí jsou vždy řetězce, můžete je použít stejně jako jakoukoli jinou proměnnou obsahující řetězec. Příklad:

"The 'Foo' environment variable is set to: $Env:Foo"
$Env:Foo += '!'
$Env:Foo

The 'Foo' environment variable is set to: An example

An example!

V PowerShellu nelze proměnnou prostředí nastavit na prázdný řetězec. Nastavení proměnné prostředí na $null nebo prázdný řetězec ho odebere z aktuální relace. Příklad:

$Env:Foo = ''
$Env:Foo | Get-Member -MemberType Properties

Get-Member : You must specify an object for the Get-Member cmdlet.
At line:1 char:12
+ $Env:foo | Get-Member
+            ~~~~~~~~~~
    + CategoryInfo          : CloseError: (:) [Get-Member], InvalidOperationException
    + FullyQualifiedErrorId : NoObjectInGetMember,Microsoft.PowerShell.Commands.GetMemberCommand

Get-Member vrátila chybu, protože byla odebrána proměnná prostředí. Uvidíte, že nevrátí chybu, když ji použijete u prázdného řetězce:

'' | Get-Member -MemberType Properties

   TypeName: System.String

Name   MemberType Definition
----   ---------- ----------
Length Property   int Length {get;}

Další informace o proměnných v PowerShellu najdete v tématu about_Variables.

Použijte zprostředkovatele prostředí a cmdlety položky

Poskytovatel prostředí PowerShellu poskytuje rozhraní pro interakci s proměnnými prostředí ve formátu, který se podobá jednotce systému souborů. Umožňuje získat, přidat, změnit, vymazat a odstranit proměnné prostředí a hodnoty v PowerShellu.

Pokud chcete například vytvořit Foo proměnnou prostředí s hodnotou Bar:

New-Item -Path Env:\Foo -Value 'Bar'

Name                           Value
----                           -----
Foo                            Bar

Proměnnou prostředí můžete také zkopírovat pomocí Copy-Item, nastavit hodnotu proměnné prostředí pomocí Set-Item, vypsat proměnné prostředí s Get-Itema odstranit proměnnou prostředí pomocí Remove-Item.

Copy-Item -Path Env:\Foo -Destination Env:\Foo2 -PassThru
Set-Item -Path Env:\Foo2 -Value 'BAR'
Get-Item -Path Env:\Foo*
Remove-Item -Path Env:\Foo* -Verbose

Name                           Value
----                           -----
Foo2                           Bar

Name                           Value
----                           -----
Foo2                           BAR
Foo                            Bar

VERBOSE: Performing the operation "Remove Item" on target "Item: Foo2".
VERBOSE: Performing the operation "Remove Item" on target "Item: Foo".

Pomocí rutiny Get-ChildItem zobrazíte úplný seznam proměnných prostředí:

Get-ChildItem Env:

Další informace o použití zprostředkovatele prostředí ke správě proměnných prostředí najdete v tématu about_Environment_Provider.

Použití metod System.Environment

Třída System.Environment poskytuje GetEnvironmentVariable() a SetEnvironmentVariable() metody pro získání a úpravu proměnných prostředí.

Následující příklad vytvoří novou proměnnou prostředí , Foos hodnotou Bar a poté vrátí její hodnotu.

[Environment]::SetEnvironmentVariable('Foo','Bar')
[Environment]::GetEnvironmentVariable('Foo')

Bar

Proměnnou SetEnvironmentVariable() prostředí můžete pomocí metody odebrat zadáním prázdného řetězce pro hodnotu proměnné. Pokud chcete například odebrat proměnnou Foo prostředí:

[Environment]::SetEnvironmentVariable('Foo','')
[Environment]::GetEnvironmentVariable('Foo')

Další informace o metodách třídy System.Environment naleznete v tématu Metody prostředí.

Vytváření trvalých proměnných prostředí ve Windows

Ve Windows existují tři metody pro provedení trvalé změny proměnné prostředí:

Nastavení v profilu
SetEnvironmentVariable() Použití metody
Použití systémového Ovládací panely

Nastavení proměnných prostředí ve vašem profilu

Jakákoli proměnná prostředí, kterou přidáte nebo změníte v profilu PowerShellu, je dostupná v jakékoli relaci, která načte váš profil. Tato metoda funguje pro libovolnou verzi PowerShellu na libovolné podporované platformě.

Pokud chcete například vytvořit proměnnou CompanyUri prostředí a aktualizovat PATH proměnnou prostředí tak, aby zahrnovala C:\Tools složku, přidejte do profilu PowerShellu následující řádky:

$Env:CompanyUri = 'https://internal.contoso.com'
$Env:PATH += ';C:\Tools'

Cestu k profilu PowerShellu můžete získat pomocí $PROFILE automatické proměnné. Další informace o profilech najdete v tématu about_Profiles.

Nastavení proměnných prostředí pomocí SetEnvironmentVariable()

Ve Windows můžete jako třetí parametr zadat obor metody SetEnvironmentVariable() , který nastaví proměnnou prostředí v daném oboru. Obory počítačů i uživatelů se uchovávají mimo aktuální proces a umožňují uložit novou nebo změněnou proměnnou prostředí.

Pokud chcete například uložit novou proměnnou Foo prostředí s hodnotou Bardo oboru počítače:

[Environment]::SetEnvironmentVariable('Foo', 'Bar', 'Machine')

Proměnnou prostředí můžete odstranit z oboru uživatele nebo počítače nastavením hodnoty proměnné na prázdný řetězec.

[Environment]::SetEnvironmentVariable('Foo', '', 'Machine')

Nastavení proměnných prostředí v systémovém Ovládací panely

V Ovládací panely systému můžete přidat nebo upravit existující proměnné prostředí v oborech User and System (počítač). Systém Windows tyto hodnoty zapíše do registru, aby se zachovaly napříč relacemi a restartováním systému.

Pokud chcete provést trvalou změnu proměnné prostředí ve Windows pomocí systémového Ovládací panely:

Otevřete systémovou Ovládací panely.
Vyberte Systém.
Vyberte Upřesnit nastavení systému.
Přejděte na kartu Upřesnit .
Vyberte proměnné prostředí....
Proveďte změny.

Proměnné prostředí PowerShellu

Funkce PowerShellu můžou používat proměnné prostředí k ukládání uživatelských předvoleb. Tyto proměnné fungují jako proměnné předvoleb, ale dědí se podřízenými relacemi relací, ve kterých se vytvářejí. Další informace o proměnných předvoleb najdete v tématu about_Preference_Variables.

Mezi proměnné prostředí, které ukládají předvolby, patří:

PSExecutionPolicyPreference

Uloží zásadu spouštění nastavenou pro aktuální relaci. Tato proměnná prostředí existuje pouze v případě, že nastavíte zásady spouštění pro jednu relaci. Můžete to udělat dvěma různými způsoby.
- Spusťte relaci z příkazového řádku pomocí parametru ExecutionPolicy a nastavte zásady spouštění relace.
- Použijte rutinu Set-ExecutionPolicy . Použijte parametr Scope s hodnotou Process.
- Ručně nastavte proměnnou prostředí. Změna hodnoty této proměnné změní zásady provádění aktuálního procesu.
Tyto informace platí jenom pro platformu Windows. Další informace najdete v tématu about_Execution_Policies.
PSModulePath

$Env:PSModulePath Proměnná prostředí obsahuje seznam umístění složek, ve kterých se hledají moduly a prostředky.

Ve výchozím nastavení jsou efektivní umístění přiřazená $Env:PSModulePath :
- Systémová umístění: Tyto složky obsahují moduly, které jsou dodávány pomocí PowerShellu. Moduly se ukládají do $PSHOME\Modules umístění. Toto je také umístění, kde jsou nainstalované moduly pro správu Systému Windows.
- Moduly nainstalované uživatelem: Jedná se o moduly nainstalované uživatelem. Install-Module má parametr Scope, který umožňuje určit, zda je modul nainstalován pro aktuálního uživatele nebo pro všechny uživatele. Další informace naleznete v tématu Install-Module.
  - Umístění oboru CurrentUser specifické pro uživatele ve Windows je $HOME\Documents\PowerShell\Modules složka. Umístění oboru AllUsers je $Env:ProgramFiles\PowerShell\Modules.
Kromě toho instalační programy, které instalují moduly v jiných adresářích, například v adresáři Program Files, mohou připojit jejich umístění k hodnotě $Env:PSModulePath.

Další informace najdete v tématu about_PSModulePath.
PSModuleAnalysisCachePath

PowerShell poskytuje kontrolu nad souborem, který slouží k ukládání dat o modulech a jejich rutinách do mezipaměti. Mezipaměť se při spuštění přečte při hledání příkazu a zapíše se do vlákna na pozadí někdy po importu modulu.

Výchozí umístění mezipaměti je:
- $Env:LOCALAPPDATA\Microsoft\Windows\PowerShell
Výchozí název souboru mezipaměti je ModuleAnalysisCache.

Poznámka:

Pokud zjišťování příkazů nefunguje správně, například IntelliSense zobrazuje příkazy, které neexistují, můžete odstranit soubor mezipaměti. Mezipaměť se znovu vytvoří při příštím spuštění PowerShellu.

Pokud chcete změnit výchozí umístění mezipaměti, nastavte proměnnou prostředí před spuštěním PowerShellu. Hodnota by měla pojmenovat úplnou cestu (včetně názvu souboru), kterou má PowerShell oprávnění k vytváření a zápisu souborů.

Změny této proměnné prostředí ovlivňují pouze podřízené procesy. Informace o vytváření trvalých proměnných prostředí najdete v předchozích částech.

Pokud chcete zakázat mezipaměť souborů, nastavte tuto hodnotu na neplatné umístění, například:
```
# `NUL` here is a special device on Windows that can't be written to
$Env:PSModuleAnalysisCachePath = 'NUL'
```
Tím se nastaví cesta k zařízení NUL . PowerShell nemůže zapisovat do cesty, ale nevrátí se žádná chyba. Chyby hlášené pomocí traceru můžete zobrazit:
```
Trace-Command -PSHost -Name Modules -Expression {
  Import-Module Microsoft.PowerShell.Management -Force
}
```
PSDisableModuleAnalysisCacheCleanup

Při zápisu mezipaměti analýzy modulů PowerShell kontroluje moduly, které už neexistují, aby nedocházelo k zbytečně velké mezipaměti. Někdy tyto kontroly nejsou žádoucí, v takovém případě je můžete vypnout nastavením této hodnoty proměnné prostředí na 1hodnotu .

Nastavení této proměnné prostředí se projeví u následných událostí čištění v aktuálním procesu. Pokud chcete zajistit, aby bylo čištění při spuštění zakázané, musíte před spuštěním PowerShellu nastavit proměnnou prostředí. Informace o vytváření trvalých proměnných prostředí najdete v předchozích částech.

Další proměnné prostředí, které používá PowerShell

Informace o cestě

PATH

$Env:PATH Proměnná prostředí obsahuje seznam umístění složek, která operační systém hledá spustitelné soubory. Ve Windows je seznam umístění složek oddělený středníkem (;) znakem.
PATHEXT

Proměnná $Env:PATHEXT obsahuje seznam přípon souborů, které systém Windows považuje za spustitelné soubory. Když se soubor skriptu s jednou z uvedených rozšíření spustí z PowerShellu, skript se spustí v aktuální konzole nebo relaci terminálu. Pokud není přípona souboru uvedená, skript se spustí v nové relaci konzoly.

Chcete-li zajistit, aby se skripty pro jiný skriptovací jazyk spouštěly v aktuální relaci konzoly, přidejte příponu souboru používanou skriptovacím jazykem. Pokud chcete například spouštět skripty Pythonu v aktuální konzole, přidejte .py rozšíření do proměnné prostředí. Aby systém Windows podporoval příponu .py jako spustitelný soubor, musíte příponu souboru zaregistrovat pomocí ftype příkazů a assoc příkazů příkazového prostředí CMD. PowerShell nemá žádnou přímou metodu registrace obslužné rutiny souboru. Další informace najdete v dokumentaci k příkazu ftype .

Skripty PowerShellu se vždy spouštějí v aktuální relaci konzoly. Rozšíření nemusíte přidávat .ps1 .

Viz také

Váš názor

Byla tato stránka užitečná?

Last updated on 2025-09-29