win_path — Управление переменными среды PATH Windows

Новая в версии 2.3.

Обзор
Параметры
Примечания
Примеры
Статус
Техническое обслуживание
- Поддержка
- Автор

Обзор

Позволяет упорядочивать, добавлять и удалять переменные среды PATH Windows на основе элементов.

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
elements обязательно		Один элемент пути или список элементов пути (то есть директорий) для добавления или удаления. При включении в список нескольких элементов (и `state` является `present`), элементы гарантированно будут отображаться в том же относительном порядке в результирующем значении пути. Разрешены расширения переменных (например, `%VARNAME%`), и они сохраняются в целевом элементе пути в нерасширенном виде. Все существующие элементы пути, не упомянутые в `elements`, всегда сохраняются в их текущем порядке. Новые элементы пути добавляются в конец пути, а существующие элементы пути могут быть перемещены ближе к концу для удовлетворения запрошенного порядка. Пути сравниваются без учета регистра, а заключительные обратные слэши игнорируются для целей сравнения. Однако обратите внимание, что заключительные обратные слэши в YAML требуют кавычек.
name	Значение по умолчанию: "PATH"	Имя целевой переменной среды пути.
scope	Варианты: machine ← user	Уровень, на котором должна управляться переменная среды, указанная в `name`, (либо для текущего пользователя, либо для глобальной области действия машины).
state	Варианты: absent present	Указывает, должны ли указанные в `elements` элементы пути присутствовать или отсутствовать.

Примечания

Примечание

Этот модуль предназначен для изменения отдельных элементов переменных среды, подобных пути. Для общего управления другими переменными среды используйте модуль win_environment.
Этот модуль не транслирует события изменения. Это означает, что небольшое число приложений Windows, которые могут изменять свою среду без перезапуска, не будут уведомлены, и им, следовательно, потребуется перезапуск для получения новых настроек среды. Для переменных среды на уровне пользователя потребуется, чтобы пользователь вышел и снова вошёл в систему, прежде чем они станут доступными.

Примеры

- 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

Статус

Этот модуль помечен как превью, что означает, что его интерфейс не гарантируется как обратная совместимость.

Техническое обслуживание

Этот модуль помечен как ядро, что означает, что он поддерживается Командой ядра Ansible. Дополнительную информацию см. в разделе Техническое обслуживание и поддержка модулей.

Список других модулей, которые также поддерживаются Командой ядра Ansible, см. в разделе здесь.

Поддержка

Дополнительную информацию о поддержке этого модуля компанией Red Hat см. в этой статье базы знаний

Автор

Matt Davis (@nitzmahone)

Подсказка

Если вы обнаружите какие-либо проблемы в этой документации, вы можете отредактировать этот документ, чтобы улучшить его.

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.6/modules/win_path_module.html