Командная строка

RapidEE позволяет создавать, удалять, редактировать переменные окружения и экспортировать их в .reg-файл через параметры командной строки.

Синтаксис

.\RapidEE.exe [параметры] <имя_переменной> [значение]
.\RapidEE.exe -B [-M] [-U] <файл.reg>
.\RapidEE.exe -?

В угловых скобках указаны обязательные аргументы, в квадратных — необязательные. Скобки вводить не нужно.

Укажите имя переменной и её значение. Значение может содержать список элементов, разделённых ;. Аргументы с пробелами или ; заключайте в кавычки.

Параметры можно записывать с дефисом (-S) или слешем (/S) в любом регистре. В примерах используется дефис.

Параметры

Действия

Параметр	Действие
`-S`	Создать переменную или заменить её значение целиком. Действие по умолчанию.
`-A`	Добавить значение в конец списка через `;`.
`-I`	Вставить значение в начало списка через `;`.
`-R`	Удалить все элементы списка, совпадающие с указанным значением, без учёта регистра.
`-C`	Удалить пустые элементы и дубликаты. Оставляются первые вхождения.
`-D`	Удалить переменную.

Если действие не указано, RapidEE использует -S:

.\RapidEE.exe MY_VARIABLE hello

Команда записывает hello в MY_VARIABLE.

Область и тип переменной

Параметр	Действие
`-U`	Переменные текущего пользователя. Область по умолчанию.
`-M`	Системные переменные. Для изменения обычно нужны права администратора.
`-E`	Записать значение как расширяемую строку (`REG_EXPAND_SZ`).
`-N`	Записать значение как обычную строку (`REG_SZ`).

Резервная копия и справка

Параметр	Действие
`-B`	Экспортировать переменные в `.reg`-файл.
`-?`	Показать справку.

Примеры

Создать или заменить переменную

.\RapidEE.exe -S -U MY_VARIABLE "hello world"

Команда создаёт пользовательскую переменную MY_VARIABLE со значением hello world или заменяет её текущее значение.

Сохранить ссылку на другую переменную

.\RapidEE.exe -S -E -U MY_TOOLS "%USERPROFILE%\Tools"

Команда сохраняет %USERPROFILE%\Tools как расширяемую строку. PowerShell передаёт ссылку буквально.

В cmd.exe поставьте ^ перед знаками %, чтобы оболочка не раскрыла ссылку до запуска RapidEE:

.\RapidEE.exe -S -E -U MY_TOOLS ^%USERPROFILE^%\Tools

Тип REG_EXPAND_SZ позволяет Windows раскрывать ссылки позднее, при формировании окружения.

Добавить каталог в PATH

.\RapidEE.exe -A -C -U PATH "C:\Tools\bin"

Команда добавляет каталог в конец пользовательского PATH. -C удаляет пустые элементы и дубликаты из результата.

.\RapidEE.exe -I -C -M PATH "C:\PriorityTools\bin"

Команда вставляет каталог в начало системного PATH и очищает результат. Запускайте её с правами администратора.

Удалить элемент списка

.\RapidEE.exe -R -U PATH "C:\Tools"

Команда удаляет все полностью совпадающие элементы из пользовательского PATH без учёта регистра. -R сравнивает целые элементы: C:\Tools не совпадает с C:\Tools\bin или C:\Tools\. Для удаления нескольких разных элементов выполните отдельную команду для каждого.

Удалить переменную

.\RapidEE.exe -D -U MY_VARIABLE

Команда удаляет пользовательскую переменную MY_VARIABLE.

Очистить список

.\RapidEE.exe -S -C -U MY_LIST "one;two;one;;two"

Команда записывает one;two в MY_LIST.

-C очищает результат операции, сохраняя первые вхождения в исходном порядке. Пути C:\Tools\, C:/Tools и C:\Tools считаются одинаковыми: регистр, вид разделителя и завершающий слеш не учитываются.

Резервная копия

.\RapidEE.exe -B "C:\Backups\environment.reg"

Команда экспортирует системные и пользовательские переменные.

.\RapidEE.exe -B -M "C:\Backups\system.reg"

Команда экспортирует только системные переменные.

.\RapidEE.exe -B -U "C:\Backups\user.reg"

Команда экспортирует только пользовательские переменные.

Папка назначения должна существовать. Существующий файл перезаписывается. Для восстановления импортируйте .reg-файл через редактор реестра Windows. Для импорта системных переменных нужны права на их изменение.

Использование в скриптах

Код завершения	Значение
`0`	Операция выполнена успешно.
`1`	Ошибка: не указано имя переменной, нет доступа к реестру, не удалось записать файл и т. п.

$process = Start-Process -FilePath '.\RapidEE.exe' `
    -ArgumentList '-S', '-U', 'MY_VARIABLE', 'hello' `
    -Wait -PassThru
if ($process.ExitCode -ne 0) {
    throw 'Не удалось изменить переменную окружения.'
}

Start-Process -Wait -PassThru дожидается завершения RapidEE и возвращает процесс с кодом завершения. При ошибке скрипт вызывает исключение.

После изменения переменной RapidEE уведомляет другие приложения. Уже открытые PowerShell и cmd.exe сохраняют прежнее окружение. Новую оболочку запускайте из приложения, которое обновило своё окружение.

Параметры установщика RapidEE_setup.exe описаны отдельно: тихая установка.