Spec-Zone.ru › Ansible 2.10

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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API