community.vmware.vmware_vcenter_settings 模块 – 配置 vCenter Server 上的常规设置
注意
此模块是 community.vmware 集合 (版本 5.2.0) 的一部分。
如果您使用的是 ansible
包,您可能已经安装了这个集合。它不包含在 ansible-core
中。要检查是否已安装,请运行 ansible-galaxy collection list
。
要安装它,请使用:ansible-galaxy collection install community.vmware
。
要在 playbook 中使用它,请指定:community.vmware.vmware_vcenter_settings
。
概要
此模块可用于配置 vCenter Server 常规设置(统计信息除外)。
统计信息可以使用模块 community.vmware.vmware_vcenter_statistics 进行配置。
参数
参数 |
注释 |
---|---|
高级设置的字典。 默认值: |
|
vCenter Server 的数据库设置。 默认值: |
|
事件清理。 选择
|
|
事件保留天数。 默认值: |
|
最大连接数。 默认值: |
|
任务清理。 选择
|
|
任务保留天数。 默认值: |
|
vSphere vCenter 或 ESXi Server 的主机名或 IP 地址。 如果未在任务中指定该值,则将改用环境变量 |
|
vCenter Server 用于日志文件的详细程度。 选择
|
|
vCenter Server 用于发送电子邮件警报的设置。 默认值: |
|
邮件发件人地址。 |
|
邮件服务器。 |
|
vSphere vCenter 或 ESXi Server 的密码。 如果未在任务中指定该值,则将改用环境变量 |
|
将接收所有 HTTPS 请求并转发它们的 HTTP 代理的端口。 如果未在任务中指定该值,则将改用环境变量 |
|
vCenter Server 的唯一运行时设置。 |
|
vCenter Server 管理地址。 |
|
vCenter Server 唯一 ID。 |
|
vCenter Server 名称。默认值为 FQDN。 |
|
vCenter Server 警报的 SNMP 陷阱目标。 默认值: |
|
团体字符串。 默认值: |
|
启用接收器。 选择
|
|
接收器端口。 默认值: |
|
主接收器URL。 默认值: |
|
团体字符串。 默认值: |
|
启用接收器。 选择
|
|
接收器端口。 默认值: |
|
接收器 2 URL。 默认值: |
|
团体字符串。 默认值: |
|
启用接收器。 选择
|
|
接收器端口。 默认值: |
|
接收器 3 URL。 默认值: |
|
团体字符串。 默认值: |
|
启用接收器。 选择
|
|
接收器端口。 默认值: |
|
接收器 4 URL。 默认值: |
|
vCenter 服务器连接超时,用于普通和长时间操作。 默认值: |
|
长时间操作超时。 默认值: |
|
普通操作超时。 默认值: |
|
vCenter 服务器安装的用户目录设置。 默认值: |
|
查询限制。 选择
|
|
查询限制大小。 默认值: |
|
用户目录超时。 默认值: |
|
邮件验证。 选择
|
|
验证周期。 默认值: |
|
vSphere vCenter 或 ESXi 服务器的用户名。 如果任务中未指定该值,则将使用环境变量 |
|
允许在 SSL 证书无效时进行连接。当证书不受信任时设置为 如果任务中未指定该值,则将使用环境变量 选择
|
说明
注意
所有模块都需要 API 写入访问权限,因此在免费 ESXi 许可证上不受支持。
所有变量和 VMware 对象名称都区分大小写。
示例
- name: Configure vCenter general settings
community.vmware.vmware_vcenter_settings:
hostname: '{{ vcenter_hostname }}'
username: '{{ vcenter_username }}'
password: '{{ vcenter_password }}'
database:
max_connections: 50
task_cleanup: true
task_retention: 30
event_cleanup: true
event_retention: 30
runtime_settings:
unique_id: 1
managed_address: "{{ lookup('dig', inventory_hostname) }}"
vcenter_server_name: "{{ inventory_hostname }}"
user_directory:
timeout: 60
query_limit: true
query_limit_size: 5000
validation: true
validation_period: 1440
mail:
server: mail.example.com
sender: vcenter@{{ inventory_hostname }}
snmp_receivers:
snmp_receiver_1_url: localhost
snmp_receiver_1_enabled: true
snmp_receiver_1_port: 162
snmp_receiver_1_community: public
timeout_settings:
normal_operations: 30
long_operations: 120
logging_options: info
delegate_to: localhost
- name: Enable Retreat Mode for cluster with MOID domain-c8 (https://kb.vmware.com/kb/80472)
community.vmware.vmware_vcenter_settings:
hostname: '{{ vcenter_hostname }}'
username: '{{ vcenter_username }}'
password: '{{ vcenter_password }}'
advanced_settings:
'config.vcls.clusters.domain-c8.enabled': 'false'
delegate_to: localhost
返回值
通用返回值记录在此处 这里,以下是此模块独有的字段
键 |
描述 |
---|---|
关于 vCenter 设置的元数据 从 1.8.0 版本开始支持 diff 模式 返回: 总是 示例: |