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

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

Описание
Параметры
Примечания
См. также
Примеры
Статус

Описание

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

Параметры

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

Примечания

Примечание

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

См. также

win_environment – Модифицировать переменные среды на хостах Windows: Официальная документация модуля win_environment.

Примеры

- 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. [ядро]

Поддержка 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.8/modules/win_path_module.html