setx

作成するか、プログラミングやスクリプトを必要とせず、ユーザーまたはシステム環境で環境変数を変更します。 Setx コマンドは、また、レジストリ キーの値を取得し、テキスト ファイルに書き込みます。

Note

このコマンドでは、システム環境の値を直接および永続的に設定するための、コマンドラインまたはプログラムによる方法のみが提供されます。 システム環境変数を使用して手動で構成できます コントロール パネルの [ またはレジストリ エディターを使用します。 設定 コマンド インタープリター (Cmd.exe) の内部では、コマンドが現在のコンソール ウィンドウのみのユーザー環境変数を設定します。

構文

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>]

パラメーター

パラメーター 説明
/s <computer> 名前またはリモート コンピューターの IP アドレスを指定します。 円記号を使用しないでください。 既定値は、ローカル コンピューターの名前です。
/u [<domain>\]<user name> 指定したユーザー アカウントの資格情報でスクリプトを実行します。 既定値は、システムのアクセス許可です。
/p [<password>] 指定されているユーザー アカウントのパスワードを指定します、 /u パラメーター。
<variable> 設定する環境変数の名前を指定します。
<value> 環境変数を設定する値を指定します。
/k <path> 変数のベースをレジストリ キーの情報に設定されるように指定します。 path では次の構文を使用します: \\<HIVE>\<KEY>\...\<Value>。 たとえば、次のようなパスを指定します: HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\TimeZoneInformation\StandardName
/f <filename> 使用するファイルを指定します。
/a <X>,<Y> 検索パラメーターとして、絶対座標およびオフセットを指定します。
/r <X>,<Y> <String> 相対座標とからのオフセットを指定 文字列 としてパラメーターを検索します。
/m システムの環境での変数の設定を指定します。 既定の設定は、ローカルの環境です。
/x ファイルを無視して、座標が表示されます、 /a, 、/r, 、および /d コマンド ライン オプションです。
/d <delimiters> 4 つの組み込みの区切り記号 (SPACE、TAB、ENTER、LINEFEED) に加えて、,\ などの区切り記号を使用することを指定します。 有効な区切り記号には、ASCII 文字が含まれます。 区切り文字の最大数は、15、組み込みの区切り記号を含みます。
/? コマンド プロンプトにヘルプを表示します。

解説

  • このコマンドは UNIX のユーティリティ SETENV に似ています。

  • このコマンドを使用すると、コマンド ライン モード、レジストリ モード、ファイル モードの 3 つのソース (モード) のいずれかから、ユーザーおよびシステム環境変数の値を設定できます。

  • このコマンドでは、レジストリのマスター環境に変数が書き込まれます。 変数の設定と setx 変数が現在のコマンド ウィンドウのみで使用できるも現在のコマンド ウィンドウにします。

  • HKEY_CURRENT_USERHKEY_LOCAL_MACHINE 、唯一サポートされているレジストリ ハイブです。 REG_DWORD、REG_EXPAND_SZ、REG_SZ および REG_MULTI_SZ は、有効な RegKey データ型。

  • レジストリ内の REG_MULTI_SZ 値にアクセスできる場合は、最初の項目のみが抽出されて使用されます。

  • このコマンドを使って、ローカルまたはシステム環境に追加された値を削除することはできません。 変数名を指定し、値を指定しないでこのコマンドを使用すると、ローカル環境から対応する値を削除できます。

  • REG_DWORD レジストリ値が抽出され、16 進数のモードで使用します。

  • ライン フィード (CRLF) のテキスト ファイルだけをファイルのモードは、キャリッジ リターンの解析をサポートします。

  • 既存の変数に対してこのコマンドを実行すると、変数の参照が削除されて、展開された値が使用されます。

    たとえば、変数 %PATH% に %JAVADIR% への参照が含まれている場合、setx を使用して %PATH% を操作すると、%JAVADIR% が展開され、その値がターゲット変数 %PATH% に直接割り当てられます。 これは、%JAVADIR% に対するその後の更新が、%PATH% 変数に反映されないことを意味します。

  • setx を使って変数に内容を割り当てるときは、1024 文字の制限があることに注意してください。

    これは、1024 文字を超えると内容がトリミングされ、そのトリミングされたテキストが対象の変数に適用されることを意味します。 このトリミングされたテキストが既存の変数に適用された場合、対象の変数によって以前に保持されていたデータが失われる可能性があります。

ローカル環境の MACHINE 環境変数に値 Brand1 を設定するには、次のように入力します。

setx MACHINE Brand1

システム環境の MACHINE 環境変数に値 Brand1 Computer を設定するには、次のように入力します。

setx MACHINE Brand1 Computer /m

PATH 環境変数で定義されている検索パスを使用するように、ローカル環境の MYPATH 環境変数を設定するには、次のように入力します。

setx MYPATH %PATH%

PATH 環境変数で定義されている検索パスを、~% に置き換えた後で使用するように、ローカル環境の MYPATH 環境変数を設定するには、次のように入力します。

setx MYPATH ~PATH~

ローカル環境の MACHINE 環境変数に、computer1 という名前のリモート コンピューター上の Brand1 を設定するには、次のように入力します。

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

computer1 という名前のリモート コンピューター上の PATH 環境変数で定義されている検索パスを使用するように、ローカル環境の MYPATH 環境変数を設定するには、次のように入力します。

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

ローカル環境の TZONE 環境変数に、HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\TimeZoneInformation\StandardName レジストリ キーで見つかる値を設定するには、次のように入力します。

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

computer1 という名前のリモート コンピューターのローカル環境の TZONE 環境変数に、HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\TimeZoneInformation\StandardName レジストリ キーで見つかる値を設定するには、次のように入力します。

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

システム環境の BUILD 環境変数に、HKEY_LOCAL_MACHINE\Software\Microsoft\WindowsNT\CurrentVersion\CurrentBuildNumber レジストリ キーで見つかる値を設定するには、次のように入力します。

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

Computer1 をという名前の値をリモート コンピューターのシステムの環境でビルドの環境変数を設定する、 HKEY_LOCAL_MACHINE\Software\Microsoft\WindowsNT\CurrentVersion\CurrentBuildNumber レジストリ キーの型。

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

内容の対応する座標と共に Ipconfig.out という名前のファイルの内容を表示するには、次のように入力します。

setx /f ipconfig.out /x

ローカル環境の IPADDR 環境変数に、Ipconfig.out ファイルの座標 5,11 で見つかる値を設定するには、次のように入力します。

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

ローカル環境の OCTET1 環境変数に、Ipconfig.out ファイルの座標 5,3 で見つかる値と区切り記号 #$*. を設定するには、次のように入力します。

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

ローカル環境の IPGATEWAY 環境変数に、Ipconfig.out ファイルの Gateway の座標を基準とする座標 0,7 で見つかる値を設定するには、次のように入力します。

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

Ipconfig.out ファイルの内容と共に、computer1 という名前のコンピューター上でその内容に対応する座標を表示するには、次のように入力します。

setx /s computer1 /u maindom\hiropln /p p@ssW23 /f ipconfig.out /x