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

Примечание

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

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

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

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

Описание

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

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
elements список / elements=строка / обязательно		Один элемент пути или список элементов пути (например, директорий) для добавления или удаления. Когда в списке указано несколько элементов (и `state` равно `present`), элементы гарантированно будут появляться в том же относительном порядке в результирующем значении пути. Разрешены расширения переменных (например, `%VARNAME%`), и они сохраняются нерасширенными в целевом элементе пути. Все существующие элементы пути, не упомянутые в `elements`, всегда сохраняются в их текущем порядке. Новые элементы пути добавляются в конец пути, а существующие элементы пути могут быть перемещены ближе к концу, чтобы удовлетворить запрошенному порядку. Пути сравниваются без учета регистра и символов конца строки игнорируются для целей сравнения. Однако обратите внимание, что символы конца строки в YAML требуют кавычек.
name строка	Значение по умолчанию: "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–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.10/collections/ansible/windows/win_path_module.html