Модуль community.windows.win_psscript_info — сбор сведений об установленных сценариях PowerShell

Примечание

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

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

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

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

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

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

Сбор сведений о сценариях PowerShell, установленных с помощью PowerShellGet.

Требования

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

PowerShellGet module

Параметры

Параметр	Комментарии
name string	Имя сценария. Поддерживаются любые шаблоны подстановки, поддерживаемые `Get-InstalledScript`. Если параметр не указан, будут возвращены все сценарии. По умолчанию: `"*"`
repository string	Имя PSRepository, из которого были установлены сценарии. Этот параметр служит фильтром для сценариев, которые будут возвращены с учётом параметра name. Будут возвращены только сценарии, установленные из зарегистрированного репозитория. Если после установки сценария репозиторий был зарегистрирован повторно с новым `SourceLocation`, совпадения не будет.

Параметр

Комментарии

name

string

Имя сценария.

Поддерживаются любые шаблоны подстановки, поддерживаемые Get-InstalledScript.

Если параметр не указан, будут возвращены все сценарии.

По умолчанию: "*"

repository

string

Имя PSRepository, из которого были установлены сценарии.

Этот параметр служит фильтром для сценариев, которые будут возвращены с учётом параметра name.

Будут возвращены только сценарии, установленные из зарегистрированного репозитория.

Если после установки сценария репозиторий был зарегистрирован повторно с новым SourceLocation, совпадения не будет.

См. также

community.windows.win_psrepository_info: Сбор сведений о PSRepository.
community.windows.win_psmodule_info: Сбор сведений о модулях PowerShell.

Примеры

- name: Get info about all script on the system
  community.windows.win_psscript_info:

- name: Get info about the Test-RPC script
  community.windows.win_psscript_info:
    name: Test-RPC

- name: Get info about test scripts
  community.windows.win_psscript_info:
    name: Test*

- name: Get info about all scripts installed from the PSGallery repository
  community.windows.win_psscript_info:
    repository: PSGallery
  register: gallery_scripts

- name: Update all scripts retrieved from above example
  community.windows.win_psscript:
    name: "{{ item }}"
    state: latest
  loop: "{{ gallery_scripts.scripts | map(attribute=name) }}"

- name: Get info about all scripts on the system
  community.windows.win_psscript_info:
  register: all_scripts

- name: Find scripts installed from a repository that isn't registered now
  set_fact:
    missing_repository_scripts: "{{
      all_scripts
      | json_query('scripts[?repository!=null && repository==repository_source_location].{name: name, version: version, repository: repository}')
      | list
    }}"

- debug:
    var: missing_repository_scripts

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

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

Ключ	Описание
scripts list / elements=dictionary	Список установленных сценариев (или пустой список, если их нет). Возвращается: всегда
additional_metadata dictionary	Дополнительные метаданные, включённые в сценарий или добавленные при его публикации. Многие из указанных здесь полей представлены на верхнем уровне в стандартизированном виде. Поэтому значения здесь могут немного отличаться. Регистр букв в именах полей может различаться; имена не нормализуются и не преобразуются в snake_case. Возвращается: при успехе
author string	Автор сценария. Возвращается: при успехе Пример: `"Ryan Ries"`
company_name string	Название компании, связанной со сценарием. Возвращается: при успехе Пример: `"Microsoft Corporation"`
copyright string	Сведения об авторских правах на сценарий. Возвращается: при успехе Пример: `"Jordan Borean 2017"`
dependencies list / elements=string	Зависимости сценария. Возвращается: при успехе
description string	Описание сценария. Возвращается: при успехе Пример: `"This scripts tests network connectivity."`
icon_uri string	Адрес значка сценария. Возвращается: при успехе Пример: `"https://raw.githubusercontent.com/scripter/script/main/logo.png"`
installed_date string	Дата установки сценария. Возвращается: при успехе Пример: `"2018-02-14T17:55:34.9620740-05:00"`
installed_location string	Путь, по которому установлен сценарий. Возвращается: при успехе Пример: `"C:\\Program Files\\WindowsPowerShell\\Scripts"`
license_uri string	Адрес лицензии сценария. Возвращается: при успехе Пример: `"https://raw.githubusercontent.com/scripter/script/main/LICENSE"`
name string	Имя сценария. Возвращается: при успехе Пример: `"Test-RPC"`
package_management_provider string	Поставщик управления пакетами PowerShellGet, использованный для установки сценария. Возвращается: при успехе Пример: `"NuGet"`
power_shell_get_format_version string	Версия формата спецификации PowerShellGet. Возвращается: при успехе Пример: `"2.0"`
project_uri string	Адрес проекта сценария. Возвращается: при успехе Пример: `"https://github.com/scripter/script"`
published_date string	Дата публикации сценария. Возвращается: при успехе Пример: `"2017-03-15T04:18:09.0000000"`
release_notes string	Примечания к выпуску сценария. Это поле для произвольного текста; не следует предполагать какой-либо определённый формат. Возвращается: при успехе Пример: `"## 1.5.5\n- Add optional param for detailed info\n\n## 1.4.7\n- Bug fix for deadlock when getting parameters in an event\n\n## 1.1.4\n- Bug fix when installing package from private feeds\n"`
repository string	PSRepository, из которого был установлен сценарий. Это значение не является историческим. Оно зависит от PSRepository, зарегистрированных сейчас для текущего пользователя. Чтобы получить имя репозитория, `repository_source_location` должен соответствовать текущему расположению источника зарегистрированного репозитория. Если соответствия нет, это значение будет соответствовать `repository_source_location`. Возвращается: при успехе Пример: `"PSGallery"`
repository_source_location string	Расположение источника репозитория, из которого был установлен сценарий. Возвращается: при успехе Пример: `"https://www.powershellgallery.com/api/v2"`
tags list / elements=string	Теги, заданные в `AdditionalMetadata` сценария. Возвращается: при успехе Пример: `["networking", "serialization", "git", "dsc"]`
updated_date string	Дата последнего обновления сценария. Возвращается: при успехе Пример: `"2019-12-31T09:20:02.0000000"`
version string	Версия сценария. Возвращается: при успехе Пример: `"1.2.3"`

Авторы

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_info_module.html