win_package – Установка/удаление устанавливаемого пакета

Новое в версии 1.7.

Описание
Параметры
Примечания
Примеры
Возвращаемые значения
Статус

Описание

Устанавливает или удаляет пакет в формате MSI или EXE.
Эти пакеты могут быть источниками из локальной файловой системы, сетевой файловой папки или URL.
Пожалуйста, ознакомьтесь с разделом "Примечания", касающимся некоторых особенностей этого модуля.

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
arguments -		Любые аргументы, необходимые установщику для установки или удаления пакета. Если пакет — MSI, не передавайте аргументы `/qn`, `/log` или `/norestart`. Начиная с Ansible 2.5, этот параметр может быть списком аргументов, и модуль будет экранировать аргументы по мере необходимости. Рекомендуется использовать строку при работе с пакетами MSI из-за особых проблем с экранированием в msiexec.
creates_path path добавлен в 2.4		Проверит существование указанного пути и использует результат для определения, установлен ли пакет. Вы можете использовать это в сочетании с `product_id` и другими `creates_*`.
creates_service - добавлен в 2.4		Проверит существование указанной службы и использует результат для определения, установлен ли пакет. Вы можете использовать это в сочетании с `product_id` и другими `creates_*`.
creates_version - добавлен в 2.4		Проверит свойство версии файла в `creates_path` и использует результат для определения, установлен ли пакет. `creates_path` ДОЛЖЕН быть задан и является файлом. Вы можете использовать это в сочетании с `product_id` и другими `creates_*`.
expected_return_code list	По умолчанию: [0, 3010]	Один или несколько кодов возврата установки пакета, указывающих на успех. До Ansible 2.4 это было только 0, но с 2.4 это и `0` и `3010`. Код возврата `3010` обычно означает, что требуется перезагрузка; значение `reboot_required` устанавливается, если код возврата — `3010`.
password -		Пароль для `user_name`, должен быть задан, когда задан `user_name`. псевдонимы: user_password
path -		Расположение устанавливаемого или удаляемого пакета. Этот пакет может быть расположен на локальной файловой системе, сетевой папке или в URL. Если путь находится в сетевой папке, а текущий транспорт WinRM не поддерживает делегирование учетных данных, то `user_name` и `user_password` должны быть заданы для доступа к файлу. В некоторых случаях этот файл будет скопирован локально на сервер для доступа, см. примечания для получения дополнительной информации. Если `state=present`, то это значение ДОЛЖНО быть задано. Если `state=absent`, то это значение не нужно задавать, если задано `product_id`.
product_id -		Идентификатор продукта устанавливаемого пакета. Используется для проверки того, уже установлен ли продукт, и получения информации об удалении, если `state=absent`. Идентификаторы продуктов установленных программ можно найти в редакторе реестра Windows по адресу `HKLM:Software\Microsoft\Windows\CurrentVersion\Uninstall` или для 32-разрядных программ по адресу `HKLM:Software\Wow6432Node\Microsoft\Windows\CurrentVersion\Uninstall`. Это ДОЛЖНО быть задано, если пакет не MSI, или путь — URL или сетевая папка, и делегирование учетных данных не используется. Вместо этого можно использовать параметры `creates_*`, но это не рекомендуется. псевдонимы: productid
state -	По умолчанию: "present"	Указывает на установку или удаление пакета. Модуль использует `product_id` и наличие в пути реестра для определения необходимости установки или удаления пакета. псевдонимы: ensure
username -		Имя пользователя с доступом к пакету, если он расположен в сетевой папке. Это необходимо только если транспорт WinRM работает через метод аутентификации, не поддерживающий делегирование учетных данных, например, Basic или NTLM. псевдонимы: user_name
validate_certs boolean добавлен в 2.4	Варианты: no yes ←	Если `no`, сертификаты SSL не будут проверены. Это следует использовать только на контролируемых сайтах с самозаверяющимися сертификатами. До Ansible 2.4 это по умолчанию было `no`.

Примечания

Примечание

Для платформ, отличных от Windows, используйте модуль package вместо этого.
При state=absent и продукт — EXE, путь может отличаться от первоначального. Если путь не задан, будет использован путь, установленный в UninstallString в реестре для данного product_id.
Не все идентификаторы продуктов имеют формат GUID, некоторые программы неправильно используют другую структуру, но этот модуль должен поддерживать любой формат.
По умолчанию все установки и удаления MSI будут выполняться с параметрами /log, /qn, /norestart.
Рекомендуется сначала загрузить пакет с URL-адреса, используя модуль win_get_url, так как это открывает больше гибкости в том, что нужно задавать при вызове win_package.
Пакеты будут временно загружены или скопированы локально, если путь — сетевое расположение и делегирование учетных данных не задано, или путь — URL, а файл — не MSI.
Все проверки установки в product_id и creates_* суммируются; если одна из них терпит неудачу, программа считается отсутствующей.

Примеры

- name: Install the Visual C thingy
  win_package:
    path: http://download.microsoft.com/download/1/6/B/16B06F60-3B20-4FF2-B699-5E9B7962F9AE/VSU_4/vcredist_x64.exe
    product_id: '{CF2BEA3C-26EA-32F8-AA9B-331F7E34BA97}'
    arguments: /install /passive /norestart

- name: Install Visual C thingy with list of arguments instead of a string
  win_package:
    path: http://download.microsoft.com/download/1/6/B/16B06F60-3B20-4FF2-B699-5E9B7962F9AE/VSU_4/vcredist_x64.exe
    product_id: '{CF2BEA3C-26EA-32F8-AA9B-331F7E34BA97}'
    arguments:
    - /install
    - /passive
    - /norestart

- name: Install Remote Desktop Connection Manager from msi
  win_package:
    path: https://download.microsoft.com/download/A/F/0/AF0071F3-B198-4A35-AA90-C68D103BDCCF/rdcman.msi
    product_id: '{0240359E-6A4C-4884-9E94-B397A02D893C}'
    state: present

- name: Uninstall Remote Desktop Connection Manager
  win_package:
    product_id: '{0240359E-6A4C-4884-9E94-B397A02D893C}'
    state: absent

- name: Install Remote Desktop Connection Manager locally omitting the product_id
  win_package:
    path: C:\temp\rdcman.msi
    state: present

- name: Uninstall Remote Desktop Connection Manager from local MSI omitting the product_id
  win_package:
    path: C:\temp\rdcman.msi
    state: absent

# 7-Zip exe doesn't use a guid for the Product ID
- name: Install 7zip from a network share specifying the credentials
  win_package:
    path: \\domain\programs\7z.exe
    product_id: 7-Zip
    arguments: /S
    state: present
    user_name: DOMAIN\User
    user_password: Password

- name: Install 7zip and use a file version for the installation check
  win_package:
    path: C:\temp\7z.exe
    creates_path: C:\Program Files\7-Zip\7z.exe
    creates_version: 16.04
    state: present

- name: Uninstall 7zip from the exe
  win_package:
    path: C:\Program Files\7-Zip\Uninstall.exe
    product_id: 7-Zip
    arguments: /S
    state: absent

- name: Uninstall 7zip without specifying the path
  win_package:
    product_id: 7-Zip
    arguments: /S
    state: absent

- name: Install application and override expected return codes
  win_package:
    path: https://download.microsoft.com/download/1/6/7/167F0D79-9317-48AE-AEDB-17120579F8E2/NDP451-KB2858728-x86-x64-AllOS-ENU.exe
    product_id: '{7DEBE4EB-6B40-3766-BB35-5CBBC385DA37}'
    arguments: '/q /norestart'
    state: present
    expected_return_code: [0, 666, 3010]

Возвращаемые значения

Общие возвращаемые значения описаны здесь, следующие поля уникальны для данного модуля:

Ключ	Возвращаемое значение	Описание
exit_code целое число	изменение произошло	См. rc, это будет удалено в пользу rc в Ansible 2.6.
log строка	изменение произошло и пакет — MSI	Содержимое журнала MSI. Пример: Установка завершена успешно
rc целое число	изменение произошло	Код возврата процесса пакета.
reboot_required булево значение	всегда	Требуется ли перезагрузка для завершения пакета. Устанавливается в true, если код возврата исполняемого файла — 3010. Пример: True
restart_required булево значение	всегда	См. reboot_required, это будет удалено в пользу reboot_required в Ansible 2.6 Пример: True
stderr строка	ошибка во время установки или удаления	Поток stderr процесса пакета. Пример: Не удалось установить программу
stdout строка	ошибка во время установки или удаления	Поток stdout процесса пакета. Пример: Установка программы

Статус

Данный модуль не гарантирует обратную совместимость интерфейса. [preview]
Этот модуль поддерживается командой разработчиков Ansible Core. [core]

Поддержка Red Hat

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

Авторы

Trond Hindenes (@trondhindenes)
Jordan Borean (@jborean93)

Подсказка

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

© 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_package_module.html