win_path – Управление переменными среды PATH операционной системы Windows

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

Обзор
Параметры
Примечания
Примеры
Статус

Обзор

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

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
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. [core]

Поддержка Red Hat

Дополнительную информацию о поддержке этого модуля Red Hat можно найти в этой статье базы знаний 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.7/modules/win_path_module.html