--- title: VMware Guest File Operation slug: homologacao-atmosphere/vmware-guest-file-operation description: Learn about the parameters and options available for the "vmware_guest_file_operation" module in this comprehensive document. Copy files to and from a virtual machine, create or delete directories within the guest operating system, and more. Find a table docTags: createdAt: 2021-12-15T18:42:36.000Z --- ## Resumo - Módulo para copiar um arquivo para uma VM, buscar um arquivo de uma VM e criar ou excluir um diretório no sistema operacional convidado. ## Parâmetros | **Parâmetro** | **Tipo** | **Escolhas \| Valor Padrão** | **Comentários** | | ----------------------- | ---------- | ----------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | cluster | string | | O cluster que hospeda a máquina virtual.Se definido, ajudará a acelerar a pesquisa de máquina virtual. | | copy | dictionary | | Copie o arquivo para vm sem a necessidade de rede.Os atributos válidos são\:src: fonte do arquivo absoluta ou relativadest: destino do arquivo, caminho deve existirsobrescrever: False ou True (não obrigatório, padrão False) | | datacenter | string | | O datacenter que hospeda a máquina virtual.Se definido, ajudará a acelerar a pesquisa de máquina virtual. | | directory | dictionary | | Crie ou exclua um diretório.Pode ser usado para criar um diretório temporário dentro do convidado usando a operação mktemp.mktemp define a variável dirno resultado com o nome do novo diretório.A opção de operação mktemp foi adicionada na versão 2.8Os atributos válidos são\:operação (str): os valores válidos são: criar, excluir, mktempcaminho (str): caminho do diretório (necessário para criar ou remover)prefixo (str): prefixo do diretório temporário (necessário para mktemp)sufixo (str): sufixo do diretório temporário (necessário para mktemp)recurse (booleano): Não obrigatório, padrão (falso) | | fetch | dictionary | | Obtenha o arquivo da máquina virtual sem a necessidade de rede.Os atributos válidos são\:src: O arquivo no sistema remoto a ser buscado. Este *deve* ser um arquivo, não um diretóriodest: destino do arquivo em localhost, o caminho deve existir | | folder | string | | Pasta de destino, caminho absoluto para encontrar um convidado existente ou criar o novo convidado.A pasta deve incluir o datacenter. O datacenter da ESX é ha-datacenterUsado apenas se vm\_id\_typefor inventory\_path.Exemplos\:pasta: / ha-datacenter / vmpasta: ha-datacenter / vmpasta: / datacenter1 / vmpasta: datacenter1 / vmpasta: / datacenter1 / vm / pasta1pasta: datacenter1 / vm / pasta1pasta: / pasta1 / datacenter1 / vmpasta: pasta1 / datacenter1 / vmpasta: / pasta1 / datacenter1 / vm / pasta2pasta: vm / pasta2pasta: pasta2 | | hostname | string | | O nome do host ou endereço IP do servidor vSphere vCenter ou ESXi.Se o valor não for especificado na tarefa, o valor da variável de ambiente VMWARE\_HOSTserá usado em seu lugar.Suporte a variável de ambiente adicionado em Ansible 2.6. | | password | string | | A senha do servidor vSphere vCenter ou ESXi.Se o valor não for especificado na tarefa, o valor da variável de ambiente VMWARE\_PASSWORDserá usado em seu lugar.Suporte a variável de ambiente adicionado em Ansible 2.6.
aliases: pass, pwd | | port | integer | Default:
443 | O número da porta do servidor vSphere vCenter ou ESXi.Se o valor não for especificado na tarefa, o valor da variável de ambiente VMWARE\_PORTserá usado em seu lugar.Suporte a variável de ambiente adicionado em Ansible 2.6. | | proxy\_host | string | | Endereço de um proxy que receberá todas as solicitações HTTPS e as retransmitirá.O formato é um nome de host ou IP.Se o valor não for especificado na tarefa, o valor da variável de ambiente VMWARE\_PROXY\_HOSTserá usado em seu lugar.Este recurso depende de uma versão do pyvmomi superior a v6.7.1.2018.12 | | proxy\_port | integer | | Porta do proxy HTTP que receberá todas as solicitações HTTPS e as retransmitirá.Se o valor não for especificado na tarefa, o valor da variável de ambiente VMWARE\_PROXY\_PORTserá usado em seu lugar. | | username | string | | O nome de usuário do servidor vSphere vCenter ou ESXi.Se o valor não for especificado na tarefa, o valor da variável de ambiente VMWARE\_USERserá usado em seu lugar.Suporte a variável de ambiente adicionado em Ansible 2.6.
aliases: admin, usuário | | validate\_certs | boolean | Escolhas:
- "false"
- "true" (default) | Permite a conexão quando os certificados SSL não são válidos. Definido para falsequando os certificados não são confiáveis.Se o valor não for especificado na tarefa, o valor da variável de ambiente VMWARE\_VALIDATE\_CERTSserá usado em seu lugar.Suporte a variável de ambiente adicionado em Ansible 2.6.Se definido como yes, certifique-se de que Python> = 2.7.9 esteja instalado na máquina fornecida. | | vm\_id - required | string | | Nome da máquina virtual com a qual trabalhar. | | vm\_id\_type | string | Escolhas:
- "uuid"
- "instance\_uuid"
- "dns\_name"
- "vm\_name" (default) | O método de identificação VMware pelo qual a máquina virtual será identificada. | | vm\_password - required | string | | A senha usada para fazer login na máquina virtual. | | vm\_username - required | string | | O usuário para fazer login na máquina virtual. | ## Notas Observação - Testado em vSphere 7.0.2 - Apenas a primeira correspondência contra vm\_id é usada, mesmo se houver várias correspondências ## Exemplos ```yaml - name: Crie um diretório dentro de um vm vmware_guest_file_operation: hostname: "{{ vcenter_hostname }}" username: "{{ vcenter_username }}" password: "{{ vcenter_password }}" datacenter: "{{ datacenter_name }}" validate_certs: no vm_id: "{{ guest_name }}" vm_username: "{{ guest_username }}" vm_password: "{{ guest_userpassword }}" directory: path: "/test" operation: create recurse: no delegate_to: localhost - name: copiar arquivo para vm vmware_guest_file_operation: hostname: "{{ vcenter_hostname }}" username: "{{ vcenter_username }}" password: "{{ vcenter_password }}" datacenter: "{{ datacenter_name }}" vm_id: "{{ guest_name }}" vm_username: "{{ guest_username }}" vm_password: "{{ guest_userpassword }}" copy: src: "files/test.zip" dest: "/root/test.zip" overwrite: False delegate_to: localhost - name: buscar arquivo de vm vmware_guest_file_operation: hostname: "{{ vcenter_hostname }}" username: "{{ vcenter_username }}" password: "{{ vcenter_password }}" datacenter: "{{ datacenter_name }}" vm_id: "{{ guest_name }}" vm_username: "{{ guest_username }}" vm_password: "{{ guest_userpassword }}" fetch: src: "/root/test.zip" dest: "files/test.zip" delegate_to: localhost ```