---
title: vCenter License
slug: homologacao-atmosphere/vcenter-license
description: Learn how to effectively use the community.vmware.vcenter_license module with this comprehensive document. Discover the various parameters such as cluster_name, datacenter, esxi_hostname, and more, that allow you to add or remove vCenter and ESXi server l
docTags: 
createdAt: 2023-03-10T20:02:10.000Z
---

## Resumo

- Adicionar e excluir vCenter, chaves de licença do servidor ESXi.

## Parâmetros

| **Parâmetro**      | **Tipo**   | **Escolhas \| Valor Padrão**                 | **Comentários**                                                                                                                                                                                                                                                                                                                                                       |
| ------------------ | ---------- | -------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| cluster\_name      | string     |                                              | Nome do cluster para aplicar a licença vSAN.                                                                                                                                                                                                                                                                                                                          |
| datacenter         | string     |                                              | O nome do datacenter a ser usado para a operação.                                                                                                                                                                                                                                                                                                                     |
| esxi\_hostname     | string     |                                              | O nome do host do servidor ESXi ao qual a licença especificada será atribuída.<br /><br />Este parâmetro é opcional.                                                                                                                                                                                                                                                  |
| hostname           | string     |                                              | O nome do host ou endereço IP do servidor vSphere vCenter.<br /><br />Se o valor não for especificado na tarefa, VMWARE\_HOST será usado o valor da variável de ambiente.                                                                                                                                                                                             |
| labels             | dictionary | Escolhas:<br />* \{"source":"ansible"}       | Os rótulos opcionais da chave de licença para gerenciar no vSphere vCenter.<br /><br />Este é um dicionário com par chave/valor.                                                                                                                                                                                                                                      |
| license - required | string     |                                              | A chave de licença para gerenciar no vSphere vCenter.                                                                                                                                                                                                                                                                                                                 |
| password           | string     |                                              | A senha do servidor vSphere vCenter.<br /><br />Se o valor não for especificado na tarefa, VMWARE\_PASSWORD será usado o valor da variável de ambiente.                                                                                                                                                                                                               |
| port               | integer    | Escolhas:<br />* 433                         | O número da porta do servidor vSphere vCenter.<br /><br />Se o valor não for especificado na tarefa, VMWARE\_PORT será usado o valor da variável de ambiente.                                                                                                                                                                                                         |
| proxy\_host        | string     |                                              | Endereço de um proxy que receberá todas as solicitações HTTPS e as retransmitirá.<br /><br />O formato é um nome de host ou um IP.<br /><br />Se o valor não for especificado na tarefa, VMWARE\_PROXY\_HOST será usado o valor da variável de ambiente.                                                                                                              |
| proxy\_port        | integer    |                                              | Porta do proxy HTTP que receberá todas as solicitações HTTPS e as retransmitirá.<br /><br />Se o valor não for especificado na tarefa, VMWARE\_PROXY\_PORT será usado o valor da variável de ambiente.                                                                                                                                                                |
| state              | string     | Escolhas:<br />* absent
* present← (default) | Se deve adicionar ( present) ou remover ( absent) a chave de licença.                                                                                                                                                                                                                                                                                                 |
| username           | string     |                                              | O nome de usuário do servidor vSphere vCenter.<br /><br />Se o valor não for especificado na tarefa, VMWARE\_USER será usado o valor da variável de ambiente.                                                                                                                                                                                                         |
| validate\_certs    | boolean    | Escolhas:<br />* false
* true ← (default)    | Permite a conexão quando os certificados SSL não são válidos. Definido para false quando os certificados não são confiáveis.<br /><br />Se o valor não for especificado na tarefa, VMWARE\_VALIDATE\_CERTS será usado o valor da variável de ambiente.<br /><br />Se definido como true, certifique-se de que Python >= 2.7.9 esteja instalado na máquina em questão. |



## Exemplos

```yaml
- name: Adicionar uma nova licença do vCenter
  community.vmware.vcenter_license:
    hostname: '{{ vcenter_hostname }}'
    username: '{{ vcenter_username }}'
    password: '{{ vcenter_password }}'
    license: f600d-21ae3-5592b-249e0-cc341
    state: present
  delegate_to: localhost

- name: Remover uma licença vCenter (não utilizada)
  community.vmware.vcenter_license:
    hostname: '{{ vcenter_hostname }}'
    username: '{{ vcenter_username }}'
    password: '{{ vcenter_password }}'
    license: f600d-21ae3-5592b-249e0-cc341
    state: absent
  delegate_to: localhost

- name: Adicione a licença ESXi e atribua ao host ESXi
  community.vmware.vcenter_license:
    hostname: '{{ vcenter_hostname }}'
    username: '{{ vcenter_username }}'
    password: '{{ vcenter_password }}'
    esxi_hostname: '{{ esxi_hostname }}'
    license: f600d-21ae3-5592b-249e0-dd502
    state: present
  delegate_to: localhost

- name: Adicione a licença do vSAN e atribua ao cluster fornecido
  community.vmware.vcenter_license:
    hostname: '{{ vcenter_hostname }}'
    username: '{{ vcenter_username }}'
    password: '{{ vcenter_password }}'
    datacenter: '{{ datacenter_name }}'
    cluster_name: '{{ cluster_name }}'
    license: f600d-21ae3-5592b-249e0-dd502
    state: present
  delegate_to: localhost

```



## Valores retornados

| **Chave** | **Tipo**               | **Retornado quando** | **Descrição**                                        |
| --------- | ---------------------- | -------------------- | ---------------------------------------------------- |
| licenses  | list / elements=string | sempre               | lista de chaves de licença após a execução do módulo |