setxsetx

作成するか、プログラミングやスクリプトを必要とせず、ユーザーまたはシステム環境で環境変数を変更します。Creates or modifies environment variables in the user or system environment, without requiring programming or scripting. Setx コマンドは、また、レジストリ キーの値を取得し、テキスト ファイルに書き込みます。The Setx command also retrieves the values of registry keys and writes them to text files.

このコマンドを使用する方法の例については、を参照してください。For examples of how to use this command, see Examples.

構文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<コンピューター >/s <Computer> 名前またはリモート コンピューターの IP アドレスを指定します。Specifies the name or IP address of a remote computer. 円記号を使用しないでください。Do not use backslashes. 既定値は、ローカル コンピューターの名前です。The default value is the name of the local computer.
/u [<ドメイン >]/u [<Domain>] 指定したユーザー アカウントの資格情報でスクリプトを実行します。Runs the script with the credentials of the specified user account. 既定値は、システムのアクセス許可です。The default value is the system permissions.
/p [<パスワード >]/p [<Password>] 指定されているユーザー アカウントのパスワードを指定します、 /u パラメーター。Specifies the password of the user account that is specified in the /u parameter.
<変数 ><Variable> 設定する環境変数の名前を指定します。Specifies the name of the environment variable that you want to set.
<値 ><Value> 環境変数を設定する値を指定します。Specifies the value to which you want to set the environment variable.
/k<パス >/k <Path> 変数のベースをレジストリ キーの情報に設定されるように指定します。Specifies that the variable is set based on information from a registry key. Pパス は次の構文を使用します。The path uses the following syntax:
\\<HIVE>\<KEY>\...\<Value>
たとえば、次のパスを指定します。For example, you might specify the following path:
HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\TimeZoneInformation\StandardName
/f<ファイル名 >/f <File name> 使用するファイルを指定します。Specifies the file that you want to use.
/a <X >、/a <X>, 検索パラメーターとして、絶対座標およびオフセットを指定します。Specifies absolute coordinates and offset as search parameters.
/r <X>, ""/r <X>, "" 相対座標とからのオフセットを指定 文字列 としてパラメーターを検索します。Specifies relative coordinates and offset from String as search parameters.
/m/m システムの環境での変数の設定を指定します。Specifies to set the variable in the system environment. 既定の設定は、ローカルの環境です。The default setting is the local environment.
/x/x ファイルを無視して、座標が表示されます、 /a, 、 /r, 、および /d コマンド ライン オプションです。Displays file coordinates, ignoring the /a, /r, and /d command-line options.
/d<区切り記号 >/d <Delimiters> などの区切り記号を指定" ,、 「または」 \ "だけでなく 4 つの組み込みの区切り記号に使用する、スペース、タブ、ENTER、および改行します。Specifies delimiters such as "," or "\" to be used in addition to the four built-in delimiters — SPACE, TAB, ENTER, and LINEFEED. 有効な区切り記号には、ASCII 文字が含まれます。Valid delimiters include any ASCII character. 区切り文字の最大数は、15、組み込みの区切り記号を含みます。The maximum number of delimiters is 15, including built-in delimiters.
/?/? コマンド プロンプトにヘルプを表示します。Displays help at the command prompt.

注釈Remarks

  • Setx コマンドは、UNIX ユーティリティ SETENV に似ています。The Setx command is similar to the UNIX utility SETENV.
  • Setx は直接かつ永続的にシステムを設定する環境変数の値のみコマンドラインまたはプログラムによる方法を提供します。Setx provides the only command-line or programmatic way to directly and permanently set system environment values. システム環境変数を使用して手動で構成できます コントロール パネルの またはレジストリ エディターを使用します。System environment variables are manually configurable through Control Panel or through a registry editor. 設定 コマンド インタープリター (Cmd.exe) の内部では、コマンドが現在のコンソール ウィンドウのみのユーザー環境変数を設定します。The set command, which is internal to the command interpreter (Cmd.exe), sets user environment variables for the current console window only.
  • 使用することができます、 setxコマンドを次の 3 つのソース (モード) のいずれかからユーザーとシステムの値を環境変数を設定します。コマンド ライン モード、レジストリ モード、またはファイル モード。You can use the setx command to set values for user and system environment variables from one of three sources (modes): Command Line Mode, Registry Mode, or File Mode.
  • Setx レジストリにマスター環境変数に書き込みます。Setx writes variables to the master environment in the registry. 変数の設定と setx 変数が現在のコマンド ウィンドウのみで使用できるも現在のコマンド ウィンドウにします。Variables set with setx variables are available in future command windows only, not in the current command window.
  • HKEY_CURRENT_USERHKEY_LOCAL_MACHINE 、唯一サポートされているレジストリ ハイブです。HKEY_CURRENT_USER and HKEY_LOCAL_MACHINE are the only supported hives. REG_DWORD、REG_EXPAND_SZ、REG_SZ および REG_MULTI_SZ は、有効な RegKey データ型。REG_DWORD, REG_EXPAND_SZ, REG_SZ, and REG_MULTI_SZ are the valid RegKey data types.
  • アクセスできるとき REG_MULTI_SZ 、レジストリでは、最初の項目のみの値が抽出され、使用できます。When you gain access to REG_MULTI_SZ values in the registry, only the first item is extracted and used.
  • 使用することはできません、 setx コマンドをローカル コンピューターまたはシステム環境に追加されている値を削除します。You cannot use the setx command to remove values that have been added to the local or system environments. 使用する 設定 変数名とローカルの環境から対応する値を削除する値はありません。You can use set with a variable name and no value to remove a corresponding value from the local environment.
  • REG_DWORD レジストリ値が抽出され、16 進数のモードで使用します。REG_DWORD registry values are extracted and used in hexadecimal mode.
  • ライン フィード (CRLF) のテキスト ファイルだけをファイルのモードは、キャリッジ リターンの解析をサポートします。File mode supports the parsing of carriage return and line feed (CRLF) text files only.

Examples

Brand1 の値に、ローカル環境でコンピューターの環境変数を設定するには、次のように入力します。To set the MACHINE environment variable in the local environment to the value Brand1, type:

setx MACHINE Brand1

値 Brand1 コンピューターにシステムの環境でコンピューターの環境変数を設定するには、次のように入力します。To set the MACHINE environment variable in the system environment to the value Brand1 Computer, type:

setx MACHINE "Brand1 Computer" /m

PATH 環境変数で定義された検索パスを使用するローカル環境で MYPATH 環境変数を設定するには、次のように入力します。To set the MYPATH environment variable in the local environment to use the search path defined in the PATH environment variable, type:

setx MYPATH %PATH%

交換した後、PATH 環境変数で定義された検索パスを使用するローカル環境で MYPATH 環境変数を設定する ~% , 、種類。To set the MYPATH environment variable in the local environment to use the search path defined in the PATH environment variable after replacing ~ with %, type:

setx MYPATH ~PATH~ 

Brand1 に Computer1 という名前のリモート コンピューター上のローカル環境でコンピューターの環境変数を設定するには、次のように入力します。To set the MACHINE environment variable in the local environment to Brand1 on a remote computer named Computer1, type:

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

Computer1 という名前のリモート コンピューター上の PATH 環境変数で定義された検索パスを使用するローカル環境で MYPATH 環境変数を設定するには、次のように入力します。To set the MYPATH environment variable in the local environment to use the search path defined in the PATH environment variable on a remote computer named Computer1, type:

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

値をローカル環境で費用の環境変数を設定する、 HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\TimeZoneInformation\StandardName レジストリ キーの型。To set the TZONE environment variable in the local environment to the value found in the HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\TimeZoneInformation\StandardName registry key, type:

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

Computer1 をという名前の値をリモート コンピューターのローカル環境で費用の環境変数を設定する、 HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\TimeZoneInformation\StandardName レジストリ キーの型。To set the TZONE environment variable in the local environment of a remote computer named Computer1 to the value found in the HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\TimeZoneInformation\StandardName registry key, type:

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

値をシステムの環境でビルドの環境変数を設定する、 HKEY_LOCAL_MACHINE\Software\Microsoft\WindowsNT\CurrentVersion\CurrentBuildNumber レジストリ キーの型。To set the BUILD environment variable in the system environment to the value found in the HKEY_LOCAL_MACHINE\Software\Microsoft\WindowsNT\CurrentVersion\CurrentBuildNumber registry key, type:

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

Computer1 をという名前の値をリモート コンピューターのシステムの環境でビルドの環境変数を設定する、 HKEY_LOCAL_MACHINE\Software\Microsoft\WindowsNT\CurrentVersion\CurrentBuildNumber レジストリ キーの型。To set the BUILD environment variable in the system environment of a remote computer named Computer1 to the value found in the HKEY_LOCAL_MACHINE\Software\Microsoft\WindowsNT\CurrentVersion\CurrentBuildNumber registry key, type:

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

内容の対応する座標、と共に Ipconfig.out、という名前のファイルの内容を表示するには、次のように入力します。To display the contents of a file named Ipconfig.out, along with the contents' corresponding coordinates, type:

setx /f ipconfig.out /x

座標 5,11 ファイル Ipconfig.out で見つかった値に、ローカル環境で IPADDR 環境変数を設定するには、次のように入力します。To set the IPADDR environment variable in the local environment to the value found at the coordinate 5,11 in the file Ipconfig.out, type:

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

座標 5, 3 Ipconfig.out 区切り記号付きのファイルで見つかった値にローカルの環境で OCTET1 環境変数を設定する "#$*." , 、種類。To set the OCTET1 environment variable in the local environment to the value found at the coordinate 5,3 in the file Ipconfig.out with delimiters "#$*.", type:

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

「ゲートウェイ」の座標に関して座標 0,7 ファイル Ipconfig.out で見つかった値に、ローカル環境で IPGATEWAY 環境変数を設定するには、次のように入力します。To set the IPGATEWAY environment variable in the local environment to the value found at the coordinate 0,7 with respect to the coordinate of "Gateway" in the file Ipconfig.out, type:

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

Ipconfig.out という名前のファイルの内容を表示する: 内容の対応する座標と共に: Computer1 という名前のコンピューターを入力します。To display the contents of a file named Ipconfig.out — along with the contents' corresponding coordinates — on a computer named Computer1, type:

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

その他の参照情報Additional references

コマンド ライン構文の記号Command-Line Syntax Key