win_path - Управление переменными среды PATH Windows
Новое в версии 2.3.
Описание
- Разрешает упорядочение, добавление и удаление переменных среды Windows PATH на основе элементов.
Параметры
| Параметр | Обязательно | По умолчанию | Варианты | Комментарии |
|---|---|---|---|---|
| elements |
да |
Один элемент пути или список элементов пути (т. е. каталогов) для добавления или удаления.
Когда в списке включено несколько элементов (и
state является present), элементы гарантированно будут появляться в том же относительном порядке в результирующем значении пути.Допускаются расширения переменных (например,
%VARNAME%), которые хранятся в целевом элементе пути без расширения.Любые существующие элементы пути, не указанные в
elements, всегда сохраняются в их текущем порядке.Новые элементы пути добавляются в конец пути, а существующие элементы пути могут перемещаться ближе к концу для удовлетворения запрошенного порядка.
Пути сравниваются без учета регистра, а конечные обратные слэши игнорируются при сравнении. Однако обратите внимание, что конечные обратные слэши в YAML требуют кавычек.
|
||
| name |
нет | PATH |
Имя целевой переменной среды пути
|
|
| scope |
нет | machine |
|
Уровень, на котором должна управляться переменная среды, указанная в
name, (либо для текущего пользователя, либо для глобальной области видимости машины). |
| state |
нет |
|
Нужно ли, чтобы элементы пути, указанные в
elements, были присутствующими или отсутствующими. |
Примеры
- name: Ensure that system32 and Powershell are present on the global system path, and in the specified order
win_path:
elements:
- '%SystemRoot%\system32'
- '%SystemRoot%\system32\WindowsPowerShell\v1.0'
- name: Ensure that C:\Program Files\MyJavaThing is not on the current user's CLASSPATH
win_path:
name: CLASSPATH
elements: C:\Program Files\MyJavaThing
scope: user
state: absent
Примечания
Примечание
- Этот модуль предназначен для изменения отдельных элементов переменных среды, похожих на путь. Для общего управления другими переменными среды используйте модуль win_environment.
- Этот модуль не транслирует события изменений. Это означает, что небольшая часть приложений Windows, которые могут изменять свою среду без перезапуска, не будут уведомлены и, следовательно, потребуют перезапуска, чтобы получить новые настройки среды. Переменные среды на уровне пользователя потребуют, чтобы интерактивный пользователь вышел из системы и снова вошел в систему, прежде чем они станут доступны.
Статус
Этот модуль помечен как предварительный, что означает, что его интерфейс не гарантируется обратной совместимостью.
Информация о техническом обслуживании
Дополнительную информацию о поддержке этого модуля компанией Red Hat см. в этом документе knowledge base article<https://access.redhat.com/articles/rhel-top-support-policies>
Дополнительную помощь в разработке модулей, если вы заинтересованы в этом, см. в Информация о сообществе и участие, Тестирование Ansible и Разработка модулей.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.4/win_path_module.html
