setx
Tworzy lub modyfikuje zmienne środowiskowe w środowisku użytkownika lub systemu bez konieczności programowania ani tworzenia skryptów. Polecenie Setx pobiera również wartości kluczy rejestru i zapisuje je w plikach tekstowych.
Uwaga
To polecenie zapewnia jedyny sposób wiersza polecenia lub programowe bezpośrednie i trwałe ustawianie wartości środowiska systemowego. Zmienne środowiskowe systemu można konfigurować ręcznie za pomocą Panelu sterowania lub za pomocą edytora rejestru. ustawić polecenie, które jest wewnętrzne dla interpretera poleceń (Cmd.exe), ustawia zmienne środowiskowe użytkownika tylko dla bieżącego okna konsoli.
Składnia
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>]
Parametry
| Parametr | Opis |
|---|---|
/s <computer> |
Określa nazwę lub adres IP komputera zdalnego. Nie używaj ukośników odwrotnych. Wartość domyślna to nazwa komputera lokalnego. |
/u [<domain>\]<user name> |
Uruchamia skrypt z poświadczeniami określonego konta użytkownika. Wartość domyślna to uprawnienia systemowe. |
/p [<password>] |
Określa hasło konta użytkownika określonego w parametrze /u. |
<variable> |
Określa nazwę zmiennej środowiskowej, którą chcesz ustawić. |
<value> |
Określa wartość, do której chcesz ustawić zmienną środowiskową. |
/k <path> |
Określa, że zmienna jest ustawiana na podstawie informacji z klucza rejestru. Ścieżka używa następującej składni: \\<HIVE>\<KEY>\...\<Value>. Można na przykład określić następującą ścieżkę: HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\TimeZoneInformation\StandardName |
/f <filename> |
Określa plik, którego chcesz użyć. |
/a <X>,<Y> |
Określa współrzędne bezwzględne i przesunięcie jako parametry wyszukiwania. |
/r <X>,<Y> <String> |
Określa współrzędne względne i przesunięcie z Ciąg jako parametry wyszukiwania. |
| /m | Określa, aby ustawić zmienną w środowisku systemowym. Ustawieniem domyślnym jest środowisko lokalne. |
| /x | Wyświetla współrzędne pliku, ignorując /a, /ri /d opcje wiersza polecenia. |
/d <delimiters> |
Określa ograniczniki, takie jak , lub \ być używane oprócz czterech wbudowanych ograniczników — SPACJA, TAB, ENTER i LINEFEED. Prawidłowe ograniczniki zawierają dowolny znak ASCII. Maksymalna liczba ograniczników wynosi 15, w tym wbudowanych ograniczników. |
| /? | Wyświetla pomoc w wierszu polecenia. |
Uwagi
To polecenie jest podobne do narzędzia UNIX SETENV.
To polecenie służy do ustawiania wartości zmiennych środowiskowych użytkownika i systemu z jednego z trzech źródeł (trybów): tryb wiersza polecenia, tryb rejestru lub tryb pliku.
To polecenie zapisuje zmienne w środowisku głównym w rejestrze. Zmienne ustawione za pomocą zmiennych setx są dostępne tylko w przyszłych oknach poleceń, a nie w bieżącym oknie polecenia.
HKEY_CURRENT_USER i HKEY_LOCAL_MACHINE są jedynymi obsługiwanymi gałęziami. REG_DWORD, REG_EXPAND_SZ, REG_SZ i REG_MULTI_SZ są prawidłowymi typami danych RegKey.
Jeśli uzyskasz dostęp do REG_MULTI_SZ wartości w rejestrze, tylko pierwszy element zostanie wyodrębniony i użyty.
Nie można użyć tego polecenia, aby usunąć wartości dodane do środowisk lokalnych lub systemowych. Tego polecenia można użyć z nazwą zmiennej i bez wartości, aby usunąć odpowiednią wartość ze środowiska lokalnego.
REG_DWORD wartości rejestru są wyodrębniane i używane w trybie szesnastkowym.
Tryb pliku obsługuje analizowanie tylko plików tekstowych powrotu karetki i zestawienia wierszy (CRLF).
Uruchomienie tego polecenia w istniejącej zmiennej powoduje usunięcie wszelkich odwołań do zmiennych i użycie rozszerzonych wartości.
Jeśli na przykład zmienna %PATH% ma odwołanie do %JAVADIR%, a %PATH% jest manipulowana przy użyciu setx, %JAVADIR% jest rozszerzana, a jej wartość jest przypisywana bezpośrednio do zmiennej docelowej %PATH%. Oznacza to, że przyszłe aktualizacje %JAVADIR% nie zostaną odzwierciedlone w zmiennej %PATH%.
Należy pamiętać, że podczas przypisywania zawartości do zmiennej przy użyciu setxistnieje limit 1024 znaków.
Oznacza to, że zawartość jest przycinana, jeśli przejdziesz ponad 1024 znaki i że przycięty tekst jest stosowany do zmiennej docelowej. Jeśli ten przycięty tekst zostanie zastosowany do istniejącej zmiennej, może to spowodować utratę danych przechowywanych wcześniej przez zmienną docelową.
Przykłady
Aby ustawić zmienną środowiskową MACHINE w środowisku lokalnym na wartość Brand1, wpisz:
setx MACHINE Brand1
Aby ustawić zmienną środowiskową MACHINE w środowisku systemowym na wartość Brand1 Computer, wpisz:
setx MACHINE Brand1 Computer /m
Aby ustawić zmienną środowiskową MYPATH w środowisku lokalnym, aby użyć ścieżki wyszukiwania zdefiniowanej w zmiennej środowiskowej PATH, wpisz:
setx MYPATH %PATH%
Aby ustawić zmienną środowiskową MYPATH w środowisku lokalnym, aby użyć ścieżki wyszukiwania zdefiniowanej w zmiennej środowiskowej PATH po zastąpieniu ~%, wpisz:
setx MYPATH ~PATH~
Aby ustawić zmienną środowiskową MACHINE w środowisku lokalnym na Brand1 na komputerze zdalnym o nazwie computer1, wpisz:
setx /s computer1 /u maindom\hiropln /p p@ssW23 MACHINE Brand1
Aby ustawić zmienną środowiskową MYPATH w środowisku lokalnym, aby użyć ścieżki wyszukiwania zdefiniowanej w zmiennej środowiskowej PATH na komputerze zdalnym o nazwie computer1, wpisz:
setx /s computer1 /u maindom\hiropln /p p@ssW23 MYPATH %PATH%
Aby ustawić zmienną środowiskową TZONE w środowisku lokalnym na wartość znajdującą się w kluczu rejestru HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\TimeZoneInformation\StandardName, wpisz:
setx TZONE /k HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\TimeZoneInformation\StandardName
Aby ustawić zmienną środowiskową TZONE w środowisku lokalnym komputera zdalnego o nazwie computer1 na wartość znalezioną w kluczu rejestru HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\TimeZoneInformation\StandardName, wpisz:
setx /s computer1 /u maindom\hiropln /p p@ssW23 TZONE /k HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\TimeZoneInformation\StandardName
Aby ustawić zmienną środowiskową BUILD w środowisku systemowym na wartość znajdującą się w kluczu rejestru HKEY_LOCAL_MACHINE\Software\Microsoft\WindowsNT\CurrentVersion\CurrentBuildNumber, wpisz:
setx BUILD /k HKEY_LOCAL_MACHINE\Software\Microsoft\WindowsNT\CurrentVersion\CurrentBuildNumber /m
Aby ustawić zmienną środowiskową BUILD w środowisku systemowym komputera zdalnego o nazwie Computer1 na wartość znalezioną w kluczu rejestru HKEY_LOCAL_MACHINE\Software\Microsoft\WindowsNT\CurrentVersion\CurrentBuildNumber, wpisz:
setx /s computer1 /u maindom\hiropln /p p@ssW23 BUILD /k HKEY_LOCAL_MACHINE\Software\Microsoft\Windows NT\CurrentVersion\CurrentBuildNumber /m
Aby wyświetlić zawartość pliku o nazwie Ipconfig.out, wraz z odpowiednimi współrzędnymi zawartości, wpisz:
setx /f ipconfig.out /x
Aby ustawić zmienną środowiskową IPADDR w środowisku lokalnym na wartość znajdującą się na współrzędnych 511 w pliku Ipconfig.out, wpisz:
setx IPADDR /f ipconfig.out /a 5,11
Aby ustawić zmienną środowiskową OCTET1 w środowisku lokalnym na wartość znajdującą się na współrzędnych 5,3 w pliku Ipconfig.out z ogranicznikami #$*., wpisz:
setx OCTET1 /f ipconfig.out /a 5,3 /d #$*.
Aby ustawić zmienną środowiskową IPGATEWAY w środowisku lokalnym na wartość znajdującą się na współrzędnych 0,7 względem współrzędnych bramy w pliku Ipconfig.out, wpisz:
setx IPGATEWAY /f ipconfig.out /r 0,7 Gateway
Aby wyświetlić zawartość pliku Ipconfig.out wraz z odpowiednimi współrzędnymi zawartości, na komputerze o nazwie computer1, wpisz:
setx /s computer1 /u maindom\hiropln /p p@ssW23 /f ipconfig.out /x