Модуль community.windows.win_feature_info – Сбор информации о функциях Windows

Примечание

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

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

Для её установки используйте: ansible-galaxy collection install community.windows.

Для использования в playbook укажите: community.windows.win_feature_info.

Добавлена в community.windows 1.4.0

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

Описание

Сбор информации о всех или конкретных установленных функциях Windows.

Параметры

Параметр	Комментарии
name строка	Если указано, используется для сопоставления `name` функции Windows для получения информации. Может содержать подстановочные символы для сопоставления нескольких функций, но подстановочные символы будут сопоставляться только с `name` функции. Если опущено, будут возвращены все функции. По умолчанию: `"*"`

Параметр

Комментарии

name

строка

Если указано, используется для сопоставления name функции Windows для получения информации.

Может содержать подстановочные символы для сопоставления нескольких функций, но подстановочные символы будут сопоставляться только с name функции.

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

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

См. также

ansible.windows.win_feature: Установка и удаление функций Windows на Windows Server.

Примеры

- name: Get info for all installed features
  community.windows.win_feature_info:
  register: feature_info
- name: Get info for a single feature
  community.windows.win_feature_info:
    name: DNS
  register: feature_info
- name: Find all features that start with 'FS'
  ansible.windows.win_feature_info:
    name: FS*

END_OF_DOCUMENT_MARKER

Значения возврата

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

Ключ	Описание
exists логический	Указывает, были ли найдены какие-либо функции на основе указанных критериев. Возвращается: всегда Пример: `true`
features список / элементы=словарь	Список найденных функций на основе критериев. Будет пустым списком, если функции не были найдены. Возвращается: всегда
additional_info словарь	Список привилегий, необходимых функции и с которыми она будет работать. Возвращается: успех
install_name строка	Действие, выполняемое после запуска, может быть `start_feature` или `stop_feature`. Возвращается: успех Пример: `"ADCertificateServicesRole"`
major_version целое число	Основная версия функции `name`. Возвращается: успех Пример: `8`
minor_version целое число	Дополнительная версия функции `name`. Возвращается: успех Пример: `0`
number_id_version целое число	Числовой идентификатор функции `name`. Возвращается: успех Пример: `16`
best_practices_model_id строка	BestPracticesModelId для функции `name`. Возвращается: успех Пример: `"Microsoft/Windows/UpdateServices"`
depends_on список / элементы=строка	Командная строка, которая будет выполнена при срабатывании действия `run_command`. Возвращается: успех Пример: `["Web-Static-Content", "Web-Default-Doc"]`
depth целое число	Глубина функции `name`. Возвращается: успех Пример: `1`
description строка	Описание функции. Возвращается: успех Пример: `"Example description of the Windows feature."`
display_name строка	Имя для отображения найденной функции. Возвращается: успех Пример: `"Active Directory Certificate Services"`
event_query строка	EventQuery для функции `name`. Будет `null` если нет значения. Возвращается: успех Пример: `"IPAMServer.Events.xml"`
feature_type строка	Тип функции `name`. Значения будут одним из `Role`, `Role Service`, `Feature`. Возвращается: успех Пример: `"Feature"`
install_state строка	Состояние установки `name`. Значения будут одним из `Available`, `Removed`, `Installed`. Возвращается: успех Пример: `"Installed"`
installed логический	Установлена ли функция `name`. Возвращается: успех Пример: `false`

имя строка	Имя найденной функции. Возвращено: успех Пример: `"AD-Certificate"`
родитель строка	Родительская функция `name`, если присутствует. Возвращено: успех Пример: `"PowerShellRoot"`
путь строка	Путь функции `name`. Возвращено: успех Пример: `"WoW64 Support"`
необходима_последующая_настройка булево	Указывает, требуется ли последующая настройка для функции `name`. Возвращено: успех Пример: `false`
описание_компонента_сервера строка	Описание функции `name`. Возвращено: успех Пример: `"ServerComponent_AD_Certificate"`
подфункции список / элементы=строка	Список имен подфункций функции `name`. Возвращено: успех Пример: `["WAS-Process-Model", "WAS-NET-Environment", "WAS-Config-APIs"]`
системная_служба список / элементы=строка	Имя службы, установленной функцией `name`. Возвращено: успех Пример: `["iisadmin", "w3svc"]`

Авторы

Larry Lane (@gamethis)

Ссылки на сборку

© 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_feature_info_module.html