win_psmodule – Добавляет или удаляет модуль Windows PowerShell
Новое в версии 2.4.
Обзор
- Этот модуль помогает устанавливать модули Windows PowerShell и регистрировать хранилища пользовательских модулей в системах на базе Windows.
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| allow_clobber boolean |
| Если yes разрешает установку модулей, содержащих команды с такими же именами, как у уже существующих команд. |
| allow_prerelease boolean добавлено в 2.8 |
| Если yes устанавливает модули, помеченные как предварительные версии.Не работает с параметрами minimum_version и/или maximum_version. Не работает, если state установлено как отсутствующее. |
| maximum_version строка добавлено в 2.8 | Максимальная версия модуля PowerShell, которую необходимо установить. | |
| minimum_version строка добавлено в 2.8 | Минимальная версия модуля PowerShell, которую необходимо установить. | |
| name строка / обязательно | Имя модуля Windows PowerShell, который необходимо установить. | |
| repository строка | Имя пользовательского хранилища для использования. | |
| required_version строка добавлено в 2.8 | Точная версия модуля PowerShell, которую необходимо установить. | |
| skip_publisher_check boolean добавлено в 2.8 |
| Если yes, позволяет установить другую версию модуля, которая уже существует на вашем компьютере, в случае, когда другая не подписана цифровым способом надёжным издателем, а самая последняя существующая модуль подписан цифровым способом надёжным издателем. |
| state строка |
| Если present устанавливается новый модуль.Если absent удаляется модуль.Если latest модуль обновляется до последней версии. Этот параметр был добавлен в версии 2.8. |
| url строка | URL пользовательского хранилища для регистрации. Этот параметр устарел и будет удален в Ansible 2.12. Используйте модуль 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.
См. также
См. также
- win_psrepository – Добавляет, удаляет или обновляет хранилище Windows PowerShell
- Официальная документация по модулю win_psrepository.
Примеры
---
- name: Add a PowerShell module
win_psmodule:
name: PowerShellModule
state: present
- name: Add an exact version of PowerShell module
win_psmodule:
name: PowerShellModule
required_version: "4.0.2"
state: present
- name: Install or update an existing PowerShell module to the newest version
win_psmodule:
name: PowerShellModule
state: latest
- name: Install newer version of built-in Windows module
win_psmodule:
name: Pester
skip_publisher_check: yes
state: present
- name: Add a PowerShell module and register a repository
win_psmodule:
name: MyCustomModule
repository: MyRepository
state: present
- name: Add a PowerShell module from a specific repository
win_psmodule:
name: PowerShellModule
repository: MyRepository
state: present
- name: Remove a PowerShell module
win_psmodule:
name: PowerShellModule
state: absent
Возвращаемые значения
Общие возвращаемые значения описаны здесь, следующие поля уникальны для этого модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| nuget_changed boolean | всегда | Истина, когда поставщик пакетов Nuget установлен. Пример: Истина |
| output строка | всегда | Сообщение, описывающее результат задачи. Пример: Модуль PowerShellCookbook установлен |
| repository_changed boolean | всегда | Истина, когда пользовательское хранилище установлено или удалено. Пример: Истина |
Статус
- Этот модуль не гарантирует обратной совместимости интерфейса. [бета-версия]
- Этот модуль поддерживается сообществом Ansible. [сообщество]
Авторы
- Wojciech Sciesinski (@it-praktyk)
- Daniele Lazzari (@dlazz)
Подсказка
Если вы обнаружите проблемы в этой документации, вы можете отредактировать этот документ, чтобы улучшить его.
© 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_psmodule_module.html
