vmware_host_lockdown — Управление правами администратора для локальной учетной записи администратора хоста ESXi
Новая в версии 2.5.
Обзор
- Этот модуль может использоваться для управления правами администратора для локальной учетной записи администратора хоста, когда задано имя хоста ESXi.
- Все параметры и значения объектов VMware чувствительны к регистру.
- Этот модуль является деструктивным, поскольку права администратора управляются с помощью API, пожалуйста, внимательно ознакомьтесь с параметрами и продолжайте.
- Укажите
hostnameкак IP-адрес или имя хоста vCenter, поскольку операции блокировки невозможны со стороны автономного сервера ESXi.
Требования
Ниже перечислены требования к хосту, на котором выполняется этот модуль.
- python >= 2.6
- PyVmomi
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| cluster_name |
Имя кластера.
Все системы хостов из заданного кластера используются для управления блокировкой.
Обязательный параметр, если
esxi_hostname не задан. |
|
| esxi_hostname |
Список имен хостов ESXi для управления блокировкой.
Обязательный параметр, если
cluster_name не задан.См. примеры для спецификаций.
|
|
| hostname str |
Имя хоста или IP-адрес сервера vCenter или ESXi vSphere.
Если значение не указано в задаче, будет использовано значение переменной среды
VMWARE_HOST. Поддержка переменных среды добавлена в версии 2.6.
|
|
| password str |
Пароль сервера vCenter или ESXi vSphere.
Если значение не указано в задаче, будет использовано значение переменной среды
VMWARE_PASSWORD. Поддержка переменных среды добавлена в версии 2.6.
псевдонимы: pass, pwd |
|
| port int (добавлен в 2.5) |
По умолчанию: 443 |
Номер порта сервера vCenter или ESXi vSphere.
Если значение не указано в задаче, будет использовано значение переменной среды
VMWARE_PORT. Поддержка переменных среды добавлена в версии 2.6.
|
| state (добавлен в 2.5) |
|
Состояние системы хостов
Если установлено значение
present, все системы хостов будут переведены в режим блокировки.Если система хоста уже находится в режиме блокировки и установлено значение
present, никаких действий не будет выполнено.Если установлено значение
absent, все системы хостов будут исключены из режима блокировки.Если система хоста уже не находится в режиме блокировки и установлено значение
absent, никаких действий не будет выполнено. |
| username str |
Имя пользователя сервера vCenter или ESXi vSphere.
Если значение не указано в задаче, будет использовано значение переменной среды
VMWARE_USER. Поддержка переменных среды добавлена в версии 2.6.
псевдонимы: admin, user |
|
| validate_certs bool |
|
Разрешает подключение, когда сертификаты SSL недействительны. Установите значение
false, когда сертификаты ненадёжны.Если значение не указано в задаче, будет использовано значение переменной среды
VMWARE_VALIDATE_CERTS. Поддержка переменных среды добавлена в версии 2.6.
Если установлено значение
yes, убедитесь, что на данном компьютере установлен Python >= 2.7.9. |
Примечания
Примечание
- Тестировалось на vSphere 6.5
Примеры
- name: Enter host system into lockdown mode
vmware_host_lockdown:
hostname: '{{ vcenter_hostname }}'
username: '{{ vcenter_username }}'
password: '{{ vcenter_password }}'
esxi_hostname: '{{ esxi_hostname }}'
state: present
- name: Exit host systems from lockdown mode
vmware_host_lockdown:
hostname: '{{ vcenter_hostname }}'
username: '{{ vcenter_username }}'
password: '{{ vcenter_password }}'
esxi_hostname: '{{ esxi_hostname }}'
state: absent
- name: Enter host systems into lockdown mode
vmware_host_lockdown:
hostname: '{{ vcenter_hostname }}'
username: '{{ vcenter_username }}'
password: '{{ vcenter_password }}'
esxi_hostname:
- '{{ esxi_hostname_1 }}'
- '{{ esxi_hostname_2 }}'
state: present
- name: Exit host systems from lockdown mode
vmware_host_lockdown:
hostname: '{{ vcenter_hostname }}'
username: '{{ vcenter_username }}'
password: '{{ vcenter_password }}'
esxi_hostname:
- '{{ esxi_hostname_1 }}'
- '{{ esxi_hostname_2 }}'
state: absent
- name: Enter all host system from cluster into lockdown mode
vmware_host_lockdown:
hostname: '{{ vcenter_hostname }}'
username: '{{ vcenter_username }}'
password: '{{ vcenter_password }}'
cluster_name: '{{ cluster_name }}'
state: present
Значения возврата
Общие значения возврата описаны здесь, следующие являются полями, уникальными для данного модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| results dict |
всегда |
Метаданные о состоянии блокировки системы хоста
Пример:
{'host_lockdown_state': {'DC0_C0': {'current_state': 'present', 'previous_state': 'absent', 'desired_state': 'present'}}}
|
Статус
Этот модуль помечен как предварительный просмотр, что означает, что он не гарантирует обратную совместимость.
Техническое обслуживание
Этот модуль помечен как сообщество, что означает, что он поддерживается сообществом Ansible. Дополнительную информацию см. в разделе Техническое обслуживание и поддержка модулей.
Список других модулей, также поддерживаемых сообществом Ansible, см. здесь.
Автор
- Abhijeet Kasurde (@Akasurde)
Подсказка
Если вы обнаружите какие-либо проблемы в этом документе, вы можете отредактировать этот документ для его улучшения.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.6/modules/vmware_host_lockdown_module.html