community.vmware.vcenter_extension модуль — Регистрация/дерегистрация расширений vCenter

Примечание

Этот модуль является частью коллекции community.vmware (версия 4.7.1).

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

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

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

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

Описание

Этот модуль можно использовать для регистрации/дерегистрации расширений vCenter.

Параметры

Параметр	Комментарии
client_type string	Требуется для `state=present`. Тип клиента, для которого предназначено расширение (win32, .net, linux и т.д.). Значение по умолчанию: `"vsphere-client-serenity"`
company string	Требуется для `state=present`. Название компании-разработчика расширения.
description string	Требуется для `state=present`. Краткое описание расширения.
email string	Требуется для `state=present`. Адрес электронной почты администратора для расширения.
extension_key string / required	Ключ расширения, которое необходимо установить или удалить.
hostname string	Имя хоста или IP-адрес сервера vSphere vCenter или ESXi. Если значение не указано в задаче, вместо него будет использовано значение переменной среды `VMWARE_HOST`.
name string	Требуется для `state=present`. Имя устанавливаемого расширения.
password алиасы: pass, pwd string	Пароль сервера vSphere vCenter или ESXi. Если значение не указано в задаче, вместо него будет использовано значение переменной среды `VMWARE_PASSWORD`.
port integer	Номер порта сервера vSphere vCenter или ESXi. Если значение не указано в задаче, вместо него будет использовано значение переменной среды `VMWARE_PORT`. Значение по умолчанию: `443`
proxy_host string	Адрес прокси-сервера, который будет получать все запросы HTTPS и перенаправлять их. Формат — имя хоста или IP-адрес. Если значение не указано в задаче, вместо него будет использовано значение переменной среды `VMWARE_PROXY_HOST`.
proxy_port integer	Порт HTTP-прокси, который будет получать все запросы HTTPS и перенаправлять их. Если значение не указано в задаче, вместо него будет использовано значение переменной среды `VMWARE_PROXY_PORT`.
server_type string	Требуется для `state=present`. Тип сервера, используемого для установки расширения (SOAP, REST, HTTP и т.д.). Значение по умолчанию: `"vsphere-client-serenity"`
ssl_thumbprint string	Требуется для `state=present`. Отпечаток SSL-сертификата сервера, размещающего расширение.
state string	Добавить или удалить расширение vCenter. Варианты: `"absent"` `"present"` ← (по умолчанию)
url string	Требуется для `state=present`. Ссылка на сервер, размещающий установочный ZIP-файл расширения.
username алиасы: admin, user string	Имя пользователя сервера vSphere vCenter или ESXi. Если значение не указано в задаче, вместо него будет использовано значение переменной среды `VMWARE_USER`.
validate_certs boolean	Разрешает подключение, когда SSL-сертификаты недействительны. Установите в `false`, если сертификаты не являются доверенными. Если значение не указано в задаче, вместо него будет использовано значение переменной среды `VMWARE_VALIDATE_CERTS`. Варианты: `false` `true` ← (по умолчанию)
version string / required	Версия устанавливаемого или удаляемого расширения.
visible boolean	Отображать расширение в диспетчере решений внутри vCenter. Варианты: `false` `true` ← (по умолчанию)

Примечания

Примечание

Все модули требуют доступа на запись в API и поэтому не поддерживаются в бесплатной лицензии ESXi.
Все переменные и имена объектов VMware чувствительны к регистру.

Примеры

- name: Register vCenter Extension
  community.vmware.vcenter_extension:
     hostname: "{{ groups['vcsa'][0] }}"
     username: "{{ vcenter_username }}"
     password: "{{ site_password }}"
     extension_key: "{{ extension_key }}"
     version: "1.0"
     company: "Acme"
     name: "Acme Extension"
     description: "acme management"
     email: "user@example.com"
     url: "https://10.0.0.1/ACME-vSphere-web-plugin-1.0.zip"
     ssl_thumbprint: "{{ ssl_thumbprint }}"
     state: present
  delegate_to: localhost
  register: register_extension

- name: Deregister vCenter Extension
  community.vmware.vcenter_extension:
     hostname: "{{ groups['vcsa'][0] }}"
     username: "{{ vcenter_username }}"
     password: "{{ site_password }}"
     extension_key: "{{ extension_key }}"
     version: "1.0"
     state: absent
  delegate_to: localhost
  register: deregister_extension

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

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

Ключ	Описание
result строка	информация об выполненной операции Возвращается: всегда Пример: `"'com.acme.Extension' installed."`

Авторы

Michael Tipton (@castawayegr)

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

© 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/vmware/vcenter_extension_module.html