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

Примечание

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

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

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

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

Обзор

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

Требования

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

PowerShellGet модуль v1.6.0+

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
allow_prerelease boolean	Варианты: нет ← да	Если `yes` устанавливает скрипты, помеченные как предварительные.
maximum_version string		Максимальная версия скрипта для установки. Не может быть использована, когда state=latest.
minimum_version string		Минимальная версия скрипта для установки. Не может быть использована, когда state=latest.
name string / обязательно		Имя скрипта, который вы хотите установить или удалить.
repository string		Зарегистрированное имя репозитория, из которого вы хотите установить скрипт. Не может быть использована, когда state=absent. Если опущено, будут проверены все репозитории. Для регистрации репозитория используйте community.windows.win_psrepository.
required_version string		Точная версия скрипта для установки. Не может использоваться с minimum_version или maximum_version. Не может быть использована, когда state=latest.
scope string	Варианты: current_user все_пользователи ←	Определяет, устанавливается ли скрипт только для `current_user` или для `all_users`.
source_password string		Часть пароля учетных данных, необходимых для доступа к репозиторию. Должна использоваться вместе с source_username.
source_username string		Часть имени пользователя учетных данных, необходимых для доступа к репозиторию. Должна использоваться вместе с source_password.
state string	Варианты: present ← absent latest	Желаемое состояние скрипта. `absent` удаляет скрипт. `latest` будет гарантировать установку самой последней доступной версии. `present` устанавливает только если скрипт отсутствует.

Примечания

Примечание

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

См. также

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

Примеры

- 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–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/community/windows/win_psscript_module.html