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

Примечание

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

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

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

Чтобы использовать модуль в плейбуке, укажите: community.windows.win_psscript.

Краткое описание
Требования
Параметры
Примечания
См. также
Примеры

Краткое описание

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

Требования

Следующие компоненты требуются на узле, выполняющем этот модуль.

Модуль PowerShellGet версии 1.6.0 или новее

Параметры

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

Примечания

Примечание

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

См. также

community.windows.win_psrepository: Добавляет, удаляет или обновляет репозиторий Windows PowerShell.
community.windows.win_psrepository_info: Собирает сведения о PSRepository.
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–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/community/windows/win_psscript_module.html