Sdílet prostřednictvím


setx

Vytvoří nebo upraví proměnné prostředí v uživatelském nebo systémovém prostředí bez nutnosti programování nebo skriptování. Příkaz Setx také načte hodnoty klíčů registru a zapíše je do textových souborů.

Note

Tento příkaz poskytuje jediný příkazový řádek nebo programový způsob, jak přímo a trvale nastavit systémové hodnoty prostředí. Systémové proměnné prostředí lze ručně konfigurovat pomocí Ovládacích panelů nebo pomocí editoru registru. Příkaz set , který je interní pro interpret příkazů (Cmd.exe), nastaví uživatelské proměnné prostředí pouze pro aktuální okno konzoly.

Syntax

setx [/s <computer> [/u [<domain>\]<user name> [/p [<password>]]]] <variable> <value> [/m]
setx [/s <computer> [/u [<domain>\]<user name> [/p [<password>]]]] <variable>] /k <path> [/m]
setx [/s <computer> [/u [<domain>\]<user name> [/p [<password>]]]] /f <filename> {[<variable>] {/a <X>,<Y> | /r <X>,<Y> <String>} [/m] | /x} [/d <delimiters>]

Parameters

Parameter Description
/s <computer> Určuje název nebo IP adresu vzdáleného počítače. Nepoužívejte zpětná lomítka. Výchozí hodnota je název místního počítače.
/u [<domain>\]<user name> Spustí skript s přihlašovacími údaji zadaného uživatelského účtu. Výchozí hodnota je systémová oprávnění.
/p [<password>] Určuje heslo uživatelského účtu, který je zadán v parametru /u .
<variable> Určuje název proměnné prostředí, kterou chcete nastavit.
<value> Určuje hodnotu, na kterou chcete nastavit proměnnou prostředí.
/k <path> Určuje, že je proměnná nastavená na základě informací z klíče registru. Cesta používá následující syntaxi: \\<HIVE>\<KEY>\...\<Value>. Můžete například zadat následující cestu: HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\TimeZoneInformation\StandardName
/f <filename> Určuje soubor, který chcete použít.
/a <X>,<Y> Určuje absolutní souřadnice a posun jako parametry hledání.
/r <X>,<Y> <String> Určuje relativní souřadnice a odsazení od pole Řetězec jako parametry vyhledávání.
/m Určuje, že se má proměnná nastavit v systémovém prostředí. Výchozí nastavení je místní prostředí.
/x Zobrazí souřadnice souboru, ignoruje možnosti příkazového řádku /a, /r a /d .
/d <delimiters> Určuje oddělovače, například , nebo \ které se mají použít jako doplněk ke čtyřem vestavěným oddělovačům – MEZERNÍK, TABULÁTOR, ENTER a POSUN řádku. Platné oddělovače obsahují libovolný znak ASCII. Maximální počet oddělovačů je 15, včetně předdefinovaných oddělovačů.
/? Zobrazí nápovědu na příkazovém řádku.

Remarks

  • Tento příkaz je podobný nástroji UNIX SETENV.

  • Tento příkaz můžete použít k nastavení hodnot proměnných uživatelského a systémového prostředí z jednoho ze tří zdrojů (režimů): Režim příkazového řádku, Režim registru nebo Režim souboru.

  • Tento příkaz zapíše proměnné do hlavního prostředí v registru. Proměnné nastavené pomocí proměnných setx jsou k dispozici pouze v budoucích příkazových oknech, nikoli v aktuálním příkazovém okně.

  • HKEY_CURRENT_USER a HKEY_LOCAL_MACHINE jsou jediné podporované úly. REG_DWORD, REG_EXPAND_SZ, REG_SZ a REG_MULTI_SZ jsou platné datové typy RegKey .

  • Pokud získáte přístup k REG_MULTI_SZ hodnotám v registru, bude extrahována a použita pouze první položka.

  • Tento příkaz nemůžete použít k odebrání hodnot přidaných do místního nebo systémového prostředí. Tento příkaz můžete použít s názvem proměnné a žádnou hodnotou k odebrání odpovídající hodnoty z místního prostředí.

  • REG_DWORD hodnoty registru se extrahují a používají v šestnáctkovém režimu.

  • Režim souborů podporuje analýzu pouze textových souborů návratu na začátek řádku a odřádkování (CRLF).

  • Spuštěním tohoto příkazu na existující proměnné odeberete všechny odkazy na proměnné a použijete rozšířené hodnoty.

    Pokud má například proměnná %PATH% odkaz na %JAVADIR%a %PATH% se manipuluje pomocí setx, %JAVADIR% se rozbalí a jeho hodnota se přiřadí přímo cílové proměnné %PATH%. To znamená, že budoucí aktualizace %JAVADIR% se v proměnné %PATH% neprojeví.

  • Uvědomte si, že při přiřazování obsahu k proměnné pomocí setx je omezen počet 1024 znaků.

    To znamená, že se obsah ořízne, pokud přejdete přes 1024 znaků a že oříznutý text se použije na cílovou proměnnou. Pokud se tento oříznutý text použije u existující proměnné, může dojít ke ztrátě dat, která byla dříve uložena cílovou proměnnou.

Examples

Chcete-li nastavit proměnnou prostředí MACHINE v místním prostředí na hodnotu Brand1, zadejte:

setx MACHINE Brand1

Chcete-li nastavit proměnnou prostředí MACHINE v systémovém prostředí na hodnotu Značka1 Počítač, zadejte:

setx MACHINE Brand1 Computer /m

Chcete-li nastavit proměnnou prostředí MYPATH v místním prostředí tak, aby používala vyhledávací cestu definovanou v proměnné prostředí PATH , zadejte:

setx MYPATH %PATH%

Chcete-li nastavit proměnnou prostředí MYPATH v místním prostředí tak, aby používala vyhledávací cestu definovanou v proměnné prostředí PATH po nahrazení ~ za %, zadejte:

setx MYPATH ~PATH~

Chcete-li nastavit proměnnou prostředí MACHINE v místním prostředí na hodnotu Značka1 ve vzdáleném počítači s názvem computer1, zadejte:

setx /s computer1 /u maindom\hiropln /p p@ssW23 MACHINE Brand1

Chcete-li nastavit proměnnou prostředí MYPATH v místním prostředí tak, aby používala vyhledávací cestu definovanou v proměnné prostředí PATH na vzdáleném počítači s názvem computer1, zadejte:

setx /s computer1 /u maindom\hiropln /p p@ssW23 MYPATH %PATH%

Chcete-li nastavit proměnnou prostředí TZONE v místním prostředí na hodnotu nalezenou v klíči registru HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\TimeZoneInformation\StandardName , zadejte:

setx TZONE /k HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\TimeZoneInformation\StandardName

Chcete-li nastavit proměnnou prostředí TZONE v místním prostředí vzdáleného počítače s názvem počítač1 na hodnotu nalezenou v klíči registru HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\TimeZoneInformation\StandardName , zadejte:

setx /s computer1 /u maindom\hiropln /p p@ssW23 TZONE /k HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\TimeZoneInformation\StandardName

Chcete-li nastavit proměnnou prostředí BUILD v systémovém prostředí na hodnotu nalezenou v klíči registru HKEY_LOCAL_MACHINE\Software\Microsoft\WindowsNT\CurrentVersion\CurrentBuildNumber , zadejte:

setx BUILD /k HKEY_LOCAL_MACHINE\Software\Microsoft\WindowsNT\CurrentVersion\CurrentBuildNumber /m

Chcete-li nastavit proměnnou prostředí BUILD v systémovém prostředí vzdáleného počítače s názvem Computer1 na hodnotu nalezenou v klíči registru HKEY_LOCAL_MACHINE\Software\Microsoft\WindowsNT\CurrentVersion\CurrentBuildNumber , zadejte:

setx /s computer1 /u maindom\hiropln /p p@ssW23  BUILD /k HKEY_LOCAL_MACHINE\Software\Microsoft\Windows NT\CurrentVersion\CurrentBuildNumber /m

Chcete-li zobrazit obsah souboru s názvem Ipconfig.out spolu s odpovídajícími souřadnicemi obsahu, zadejte:

setx /f ipconfig.out /x

Chcete-li nastavit proměnnou prostředí IPADDR v lokálním prostředí na hodnotu nalezenou na souřadnici 5,11 v souboru Ipconfig.out , zadejte:

setx IPADDR /f ipconfig.out /a 5,11

Chcete-li nastavit proměnnou prostředí OCTET1 v místním prostředí na hodnotu nalezenou na souřadnici 5,3 v souboru Ipconfig.out s oddělovači #$*., zadejte:

setx OCTET1 /f ipconfig.out /a 5,3 /d #$*.

Chcete-li nastavit proměnnou prostředí IPGATEWAY v lokálním prostředí na hodnotu nalezenou na souřadnici 0,7 vzhledem k souřadnici brány v souboru Ipconfig.out , zadejte:

setx IPGATEWAY /f ipconfig.out /r 0,7 Gateway

Chcete-li zobrazit obsah souboru Ipconfig.out spolu s odpovídajícími souřadnicemi obsahu v počítači s názvem počítač1, zadejte:

setx /s computer1 /u maindom\hiropln /p p@ssW23 /f ipconfig.out /x
  • Command-Line syntaxe