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 строка | успех | Автор скрипта. Пример: Иван Иванов | |
| company_name строка | успех | Название компании, разработавшей скрипт. Пример: Компания ООО "Мой скрипт" | |
| copyright строка | успех | Авторские права на скрипт. Пример: Петров П.П. 2023 | |
| dependencies список / элементы=строка | успех | Зависимости скрипта. | |
| description строка | успех | Описание скрипта. Пример: Этот скрипт проверяет сетевое подключение. | |
| icon_uri строка | успех | Адрес иконки скрипта. Пример: https://example.com/icon.png | |
| installed_date строка | успех | Дата установки скрипта. Пример: 2023-10-27T10:00:00 | |
| installed_location строка | успех | Путь к установке скрипта. Пример: C:\Мои скрипты | |
| license_uri строка | успех | Адрес лицензии скрипта. Пример: https://example.com/license.txt | |
| name строка | успех | Имя скрипта. Пример: Скрипт проверки | |
| package_management_provider строка | успех | Используемый поставщик управления пакетами PowerShellGet для установки скрипта. Пример: NuGet | |
| power_shell_get_format_version строка | успех | Версия спецификации формата PowerShellGet. Пример: 2.1 | |
| project_uri строка | успех | Адрес проекта скрипта. Пример: https://example.com/project | |
| published_date строка | успех | Дата публикации скрипта. Пример: 2023-10-27T10:00:00 | |
| release_notes строка | успех | Примечания к выпуску скрипта. Это поле свободного текста, и не предполагается конкретный формат. Пример: ## Внесение изменений 1.1 | |
| repository строка | успех | PSRepository, из которого был установлен скрипт. Это значение не историческое. Оно зависит от зарегистрированных PSRepositories для текущего пользователя. Значение repository_source_location должно соответствовать текущему расположению зарегистрированного репозитория, чтобы получить имя репозитория.Если соответствия нет, это значение будет соответствовать repository_source_location.Пример: PSGallery | |
| repository_source_location строка | успех | Расположение источника репозитория, из которого был установлен скрипт. Пример: https://www.powershellgallery.com/api/v2 | |
| tags список / элементы=строка | успех | Теги, определённые в AdditionalMetadata скрипта.Пример: ['сеть', 'сериализация', 'git', 'dsc'] | |
| updated_date строка | успех | Дата последнего обновления скрипта. Пример: 2023-10-27T10:00:00 | |
| version строка | успех | Версия скрипта. Пример: 1.0.0 | |
Авторы
- Иван Иванов (@иванов)
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.10/collections/community/windows/win_psscript_info_module.html