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

Примечание

Этот плагин входит в состав коллекции ansible.windows (версия 1.3.0).

Для его установки используйте: ansible-galaxy collection install ansible.windows.

Для использования в книге задач укажите: ansible.windows.win_path.

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

Описание

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

Параметры

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

Примечания

Примечание

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

См. также

ansible.windows.win_environment: Официальная документация по модулю ansible.windows.win_environment.

Примеры

- name: Ensure that system32 and Powershell are present on the global system path, and in the specified order
  ansible.windows.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
  ansible.windows.win_path:
    name: CLASSPATH
    elements: C:\Program Files\MyJavaThing
    scope: user
    state: absent

Авторы

Matt Davis (@nitzmahone)

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