Модуль community.windows.win_psscript — Установка и управление скриптами PowerShell из PSRepository

Примечание

Этот модуль входит в коллекцию community.windows (версия 2.3.0).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не включена в ansible-core. Чтобы проверить установку, выполните ansible-galaxy collection list.

Для установки используйте: ansible-galaxy collection install community.windows. Для использования этого модуля необходимы дополнительные требования. Подробности см. в разделе Требования.

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

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

Обзор

Добавление или удаление скриптов PowerShell из зарегистрированных PSRepositories.

Требования

Ниже перечислены требования к хосту, на котором будет выполняться этот модуль.

Модуль PowerShellGet версии v1.6.0 и выше

Параметры

Параметр	Комментарии
allow_prerelease boolean	Если `yes` устанавливаются скрипты, помеченные как предварительные. Выбор: `false` ← (по умолчанию) `true`
maximum_version string	Максимальная версия скрипта для установки. Не может быть использовано при state=latest.
minimum_version string	Минимальная версия скрипта для установки. Не может быть использовано при state=latest.
name string / обязательно	Имя скрипта, который вы хотите установить или удалить.
repository string	Зарегистрированное имя репозитория, из которого вы хотите установить. Не может быть использовано при state=absent. Если опущено, будут проверены все репозитории. Для регистрации репозитория используйте community.windows.win_psrepository.
...	...

Примечания

Примечание

В отличие от модулей PowerShell, скрипты не поддерживают параллельную установку нескольких версий. Установка новой версии заменит существующую.

См. также

community.windows.win_psrepository: Добавление, удаление или обновление репозитория Windows PowerShell.
community.windows.win_psrepository_info: Сбор информации о PSRepositories.
community.windows.win_psmodule: Добавление или удаление модуля Windows PowerShell.

Примеры

- name: Install a script from PSGallery
  community.windows.win_psscript:
    name: Test-RPC
    repository: PSGallery

- name: Find and install the latest version of a script from any repository
  community.windows.win_psscript:
    name: Get-WindowsAutoPilotInfo
    state: latest

- name: Remove a script that isn't needed
  community.windows.win_psscript:
    name: Defrag-Partition
    state: absent

- name: Install a specific version of a script for the current user
  community.windows.win_psscript:
    name: CleanOldFiles
    scope: current_user
    required_version: 3.10.2

- name: Install a script below a certain version
  community.windows.win_psscript:
    name: New-FeatureEnable
    maximum_version: 2.99.99

- name: Ensure a minimum version of a script is present
  community.windows.win_psscript:
    name: OldStandby
    minimum_version: 3.0.0

- name: Install any available version that fits a specific range
  community.windows.win_psscript:
    name: FinickyScript
    minimum_version: 2.5.1
    maximum_version: 2.6.19

Авторы

Brian Scholer (@briantist)

Ссылки на коллекцию

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