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 | Имя хоста или IP-адрес сервера vCenter или ESXi vSphere. Если значение не указано в задаче, вместо него используется значение переменной среды VMWARE_HOST. Поддержка переменных среды добавлена в версии 2.6. | |
| password | Пароль сервера vCenter или ESXi vSphere. Если значение не указано в задаче, вместо него используется значение переменной среды VMWARE_PASSWORD. Поддержка переменных среды добавлена в версии 2.6. псевдонимы: pass, pwd | |
| port (добавлено в 2.5) | По умолчанию: 443 | Номер порта сервера vCenter или ESXi vSphere. Если значение не указано в задаче, вместо него используется значение переменной среды VMWARE_PORT. Поддержка переменных среды добавлена в версии 2.6. |
| state (добавлено в 2.5) |
| Состояние хост-системы Если установлено значение present, все хост-системы будут переведены в режим блокировки.Если хост-система уже находится в режиме блокировки и установлено значение present, никаких действий не будет выполнено.Если установлено значение absent, все хост-системы будут исключены из режима блокировки.Если хост-система уже находится вне режима блокировки и установлено значение absent, никаких действий не будет выполнено. |
| username | Имя пользователя сервера vCenter или ESXi vSphere. Если значение не указано в задаче, вместо него используется значение переменной среды VMWARE_USER. Поддержка переменных среды добавлена в версии 2.6. псевдонимы: user, admin | |
| validate_certs |
True | Разрешает подключение, когда сертификаты SSL недействительны. Установите значение false при недоверии сертификатов.Если значение не указано в задаче, вместо него используется значение переменной среды VMWARE_VALIDATE_CERTS. Поддержка переменных среды добавлена в версии 2.6. |
Примечания
Примечание
- Тестировалось на 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', 'desired_state': 'present', 'previous_state': 'absent'}}} |
Статус
Этот модуль помечен как превью, что означает, что он не гарантирует обратную совместимость.
Автор
- 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.5/modules/vmware_host_lockdown_module.html