Модуль community.windows.win_psscript_info — Сбор информации об установленных скриптах PowerShell

Примечание

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

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

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

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

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

Описание

Сбор информации о скриптах PowerShell, установленных через PowerShellGet.

Требования

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

PowerShellGet модуль

Параметры

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

Параметр

Комментарии

name

строка

Имя скрипта.

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

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

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

repository

строка

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

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

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

Если хранилище было перерегистрировано после установки скрипта с новым SourceLocation, это не будет совпадать.

См. также

community.windows.win_psrepository_info: Сбор информации о PSRepositories.
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"`

хранилище строка	Хранилище PSRepository, откуда был установлен скрипт. Это значение не является историческим. Оно зависит от PSRepositories, которые зарегистрированы сейчас для текущего пользователя. Значение `repository_source_location` должно совпадать с текущим местоположением источника зарегистрированного хранилища, чтобы получить имя хранилища. Если совпадения нет, то это значение будет соответствовать `repository_source_location`. Возвращаемое значение: успех Пример: `"PSGallery"`
местоположение_источника_хранилища строка	Местоположение источника хранилища, откуда был установлен скрипт. Возвращаемое значение: успех Пример: `"https://www.powershellgallery.com/api/v2"`
теги список / элементы=строка	Теги, определённые в `AdditionalMetadata` скрипта. Возвращаемое значение: успех Пример: `["networking", "serialization", "git", "dsc"]`
дата_обновления строка	Дата последнего обновления скрипта. Возвращаемое значение: успех Пример: `"2019-12-31T09:20:02.0000000"`
версия строка	Версия скрипта. Возвращаемое значение: успех Пример: `"1.2.3"`

Авторы

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