community.windows.win_psscript_info – Сбор информации об установленных скриптах PowerShell
Примечание
Этот плагин является частью коллекции community.windows (версия 1.2.0).
Для его установки используйте: ansible-galaxy collection install community.windows
Чтобы использовать его в книге задач, укажите: community.windows.win_psscript_info
Обзор
- Сбор информации об установленных скриптах PowerShell через PowerShellGet.
Требования
Ниже перечислены требования к хосту, на котором будет выполняться этот модуль.
-
PowerShellGetмодуль
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| name строка | Значение по умолчанию: "*" | Имя скрипта. Поддерживает любые шаблоны подстановок, поддерживаемые Get-InstalledScriptЕсли опущен, возвращаются все скрипты. |
| repository строка | Имя PSRepository, из которого были установлены скрипты. Действует как фильтр по скриптам, которые будут возвращены в соответствии с опцией name. Будут возвращены только скрипты, установленные из зарегистрированного репозитория. Если репозиторий был перерегистрирован после установки скрипта с новым SourceLocation, он не будет соответствовать. |
См. также
См. также
- community.windows.win_psrepository_info
-
Официальная документация модуля community.windows.win_psrepository_info.
- community.windows.win_psmodule_info
-
Официальная документация модуля community.windows.win_psmodule_info.
Примеры
- 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 список / элементы=словарь | всегда | Список установленных скриптов (или пустой список, если их нет). | |
| additional_metadata словарь | успех | Дополнительные метаданные, включенные в скрипт или при публикации скрипта. Многие поля здесь отображаются на верхнем уровне со стандартизацией. Значения здесь могут незначительно отличаться в результате. Имена полей здесь сильно различаются по регистру и не приведены к нижнему регистру или в формате snake_case. | |
| author строка | успех | Автор скрипта. Пример: Ryan Ries | |
| company_name строка | успех | Название компании, разработавшей скрипт. Пример: Microsoft Corporation | |
| copyright строка | успех | Авторское право на скрипт. Пример: Jordan Borean 2017 | |
| dependencies список / элементы=строка | успех | Зависимости скрипта. | |
| description строка | успех | Описание скрипта. Пример: Этот скрипт проверяет подключение к сети. | |
| icon_uri строка | успех | Адрес значка скрипта. Пример: https://raw.githubusercontent.com/scripter/script/main/logo.png | |
| installed_date строка | успех | Дата установки скрипта. Пример: 2018-02-14T17:55:34.9620740-05:00 | |
| installed_location строка | успех | Путь установки скрипта. Пример: C:\Program Files\WindowsPowerShell\Scripts | |
| license_uri строка | успех | Адрес лицензии скрипта. Пример: https://raw.githubusercontent.com/scripter/script/main/LICENSE | |
| name строка | успех | Имя скрипта. Пример: Test-RPC | |
| package_management_provider строка | успех | Используемый поставщик управления пакетами PowerShellGet для установки скрипта. Пример: NuGet | |
| power_shell_get_format_version строка | успех | Версия спецификации формата PowerShellGet. Пример: 2.0 | |
| project_uri строка | успех | Адрес проекта скрипта. Пример: https://github.com/scripter/script | |
| published_date строка | успех | Дата публикации скрипта. Пример: 2017-03-15T04:18:09.0000000 | |
| release_notes строка | успех | Примечания к выпуску скрипта. Это свободное текстовое поле, и не следует предполагать какой-либо конкретный формат. Пример: ## 1.5.5 - Add optional param for detailed info ## 1.4.7 - Bug fix for deadlock when getting parameters in an event ## 1.1.4 - Bug fix when installing package from private feeds | |
| repository строка | успех | PSRepository, откуда был установлен скрипт. Это значение не является историческим. Оно зависит от PSRepositories, которые сейчас зарегистрированы для текущего пользователя. repository_source_location должен соответствовать текущему расположению источника зарегистрированного репозитория, чтобы получить имя репозитория.Если соответствие отсутствует, это значение будет соответствовать repository_source_location.Пример: PSGallery | |
| repository_source_location строка | успех | Расположение источника репозитория, откуда был установлен скрипт. Пример: https://www.powershellgallery.com/api/v2 | |
| tags список / элементы=строка | успех | Теги, определенные в AdditionalMetadata скрипта.Пример: ['networking', 'serialization', 'git', 'dsc'] | |
| updated_date строка | успех | Дата последнего обновления скрипта. Пример: 2019-12-31T09:20:02.0000000 | |
| version строка | успех | Версия скрипта. Пример: 1.2.3 | |
Авторы
- 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_info_module.html