community.windows.win_psmodule – Добавляет или удаляет модуль Windows PowerShell

Примечание

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

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

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

Обзор
Параметры
Примечания
См. также
Примеры
Возвращаемые значения

Обзор

Этот модуль помогает устанавливать модули Windows PowerShell и регистрировать пользовательские репозитории модулей на системах с Windows.

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
allow_clobber boolean	Варианты: нет ← да	Если `yes`, позволяет устанавливать модули, содержащие команды с теми же именами, что и уже существующие команды.
allow_prerelease boolean	Варианты: нет ← да	Если `yes`, устанавливает модули, помеченные как предварительные версии. Не работает с параметрами `minimum_version` и/или `maximum_version`. Не работает, если `state` задано как отсутствующее.
maximum_version string		Максимальная версия модуля PowerShell, который необходимо установить.
minimum_version string		Минимальная версия модуля PowerShell, который необходимо установить.
name string / обязательно		Имя модуля Windows PowerShell, который необходимо установить.
repository string		Имя пользовательского репозитория для использования.
required_version string		Точная версия модуля PowerShell, который необходимо установить.
skip_publisher_check boolean	Варианты: нет ← да	Если `yes`, позволяет установить другую версию модуля, уже существующего на компьютере, в случае, если другая версия не подписана цифровой подписью доверенным издателем, а самая последняя существующая версия подписана цифровой подписью доверенным издателем.
state string	absent latest present ←	Если `present`, устанавливается новый модуль. Если `absent`, модуль удаляется. Если `latest`, модуль обновляется до последней версии.
url string		URL пользовательского репозитория для регистрации. УСТАРЕЛО, будет удалено в новой версии после `2021-07-01`, используйте модуль community.windows.win_psrepository вместо этого.

Примечания

Примечание

Необходимые модули PowerShell - PowerShellGet >= 1.6.0 - PackageManagement >= 1.1.7
Необходимый поставщик пакетов PowerShell - NuGet >= 2.8.5.201
В PowerShell 5.x необходимые модули и поставщик пакетов будут обновлены при первом запуске модуля win_psmodule.
В PowerShell 3.x и 4.x их необходимо установить перед использованием модуля win_psmodule.

См. также

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

Примеры

---
- name: Add a PowerShell module
  community.windows.win_psmodule:
    name: PowerShellModule
    state: present

- name: Add an exact version of PowerShell module
  community.windows.win_psmodule:
    name: PowerShellModule
    required_version: "4.0.2"
    state: present

- name: Install or update an existing PowerShell module to the newest version
  community.windows.win_psmodule:
    name: PowerShellModule
    state: latest

- name: Install newer version of built-in Windows module
  community.windows.win_psmodule:
    name: Pester
    skip_publisher_check: yes
    state: present

- name: Add a PowerShell module and register a repository
  community.windows.win_psmodule:
    name: MyCustomModule
    repository: MyRepository
    state: present

- name: Add a PowerShell module from a specific repository
  community.windows.win_psmodule:
    name: PowerShellModule
    repository: MyRepository
    state: present

- name: Remove a PowerShell module
  community.windows.win_psmodule:
    name: PowerShellModule
    state: absent

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

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

Ключ	Возвращаемое значение	Описание
nuget_changed boolean	всегда	Истинно, когда поставщик пакетов Nuget установлен. Пример: Истина
output string	всегда	Сообщение, описывающее результат задачи. Пример: Модуль PowerShellCookbook установлен
repository_changed boolean	всегда	Истинно, когда пользовательский репозиторий установлен или удален. Пример: Истина

Авторы

Wojciech Sciesinski (@it-praktyk)
Daniele Lazzari (@dlazz)

© 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/community/windows/win_psmodule_module.html