New-VM

4 min

Resumo

Cria uma nova máquina virtual.

Parâmetros

Parâmetro	Tipo	Comentários
-AsJob	string	Executa o cmdlet como um trabalho em segundo plano.
-BootDevice	string	Especifica o dispositivo a ser usado como dispositivo de inicialização para a nova máquina virtual. Os valores permitidos são CD , Floppy , LegacyNetworkAdapter , IDE , NetworkAdapter e VHD. Quando LegacyNetworkAdapter é especificado, isso configura a nova máquina virtual com um adaptador de rede que pode ser usado para executar uma inicialização PXE e instalar um sistema operacional a partir de um servidor de instalação de rede. Observação: as máquinas virtuais da geração 2 não são compatíveis com disquete, LegacyNetworkAdapter ou IDE. Usar esses valores com uma máquina virtual de geração 2 causará um erro. O VHD e o NetworkAdapter são novos nas máquinas virtuais da Geração 2. Se você especificá-los em uma máquina virtual de geração 1, eles serão interpretados como IDE e LegacyNetworkAdapter, respectivamente.
-CimSession	string	Executa o cmdlet em uma sessão remota ou em um computador remoto. Insira um nome de computador ou um objeto de sessão, como a saída de um cmdlet New-CimSession ou Get-CimSession . O padrão é a sessão atual no computador local.
-ComputerName	string	Especifica um ou mais hosts Hyper-V nos quais a máquina virtual deve ser criada. Nomes NetBIOS, endereços IP e nomes de domínio totalmente qualificados são permitidos. O padrão é o computador local. Use localhost ou um ponto (.) para especificar o computador local explicitamente.
-Confirm	string	Solicita confirmação antes de executar o cmdlet.
-Credential	string	Especifica uma ou mais contas de usuário que têm permissão para executar esta ação. O padrão é o usuário atual.
-Experimental	string	Experimental
-Force	string	Force
-Generation	string	Especifica a geração, como um número inteiro, para a máquina virtual. Os valores válidos nesta versão do Windows são 1 e 2.
-MemoryStartupBytes	string	Especifica a quantidade de memória, em bytes, a ser atribuída à máquina virtual. O valor padrão é 512 MB.
-Name	string	Especifica o nome da nova máquina virtual. O nome padrão é Nova máquina virtual.
-NewVHDPath	string	Cria um novo disco rígido virtual com o caminho especificado e o conecta à nova máquina virtual. Caminhos absolutos são permitidos. Se apenas um nome de arquivo for especificado, o disco rígido virtual será criado no caminho padrão configurado para o host.
-NewVHDSizeBytes	string	Especifica o tamanho do disco rígido virtual dinâmico que é criado e anexado à nova máquina virtual.
-NoVHD	string	Cria uma máquina virtual sem anexar nenhum disco rígido virtual.
-Path	string	Especifica o diretório para armazenar os arquivos da nova máquina virtual.
-Prerelease	string	Prerelease
-SwitchName	string	Especifica o nome amigável do comutador virtual se você deseja conectar a nova máquina virtual a um comutador virtual existente para fornecer conectividade a uma rede. O Hyper-V cria automaticamente uma máquina virtual com um adaptador de rede virtual, mas conectá-lo a um comutador virtual é opcional.
-Version	string	Version
-VHDPath	string	Especifica o caminho para um arquivo de disco rígido virtual.
-WhatIf	string	Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Exemplos

# Exemplo: Este exemplo cria uma nova máquina virtual chamada new 1 com 512 MB de memória.
tasks:
  powershell_command:
    server: {{ server }}
    username: {{ username }}
    password: {{ password }}
    command: |
      New-VM -Name "new 1" -MemoryStartupBytes 512MB
  register: result
- debug:
    msg: |
      {{ result.output }}
      {{ result.had_errors }}
      {{ result.output_errors }}
      {{ result.output_warnings }}

# Exemplo: Este exemplo cria uma máquina virtual chamada new 2 que tem 1 GB de memória e que está conectada a um novo disco rígido virtual de 40 GB que usa o formato VHDX.
tasks:
  powershell_command:
    server: {{ server }}
    username: {{ username }}
    password: {{ password }}
    command: |
      New-VM -Name "new 2" -MemoryStartupBytes 1GB -NewVHDPath d:\vhd\base.vhdx -NewVHDSizeBytes 40GB
  register: result
- debug:
    msg: |
      {{ result.output }}
      {{ result.had_errors }}
      {{ result.output_errors }}
      {{ result.output_warnings }}

# Exemplo: Este exemplo cria uma máquina virtual chamada new 3 com 1 GB de memória e a conecta a um disco rígido virtual existente que usa o formato VHDX.
tasks:
  powershell_command:
    server: {{ server }}
    username: {{ username }}
    password: {{ password }}
    command: |
      New-VM -Name "new 3" -MemoryStartupBytes 1GB -VHDPath d:\vhd\BaseImage.vhdx
  register: result
- debug:
    msg: |
      {{ result.output }}
      {{ result.had_errors }}
      {{ result.output_errors }}
      {{ result.output_warnings }}

# Exemplo: Este exemplo solicita credenciais e cria uma máquina virtual chamada new 4, que tem 2 GB de memória, no servidor chamado HostServer01.
tasks:
  powershell_command:
    server: {{ server }}
    username: {{ username }}
    password: {{ password }}
    command: |
      New-VM -Name "new 4" -MemoryStartupBytes 2GB -Credential (Get-Credential) -ComputerName HostServer01
  register: result
- debug:
    msg: |
      {{ result.output }}
      {{ result.had_errors }}
      {{ result.output_errors }}
      {{ result.output_warnings }}

# Exemplo: Este exemplo cria uma máquina virtual chamada new 5. A máquina não possui nenhum disco VHD e está configurada para inicializar a partir do CD.
tasks:
  powershell_command:
    server: {{ server }}
    username: {{ username }}
    password: {{ password }}
    command: |
      New-VM -Name "new 5" -Generation 1 -BootDevice CD -NoVHD
  register: result
- debug:
    msg: |
      {{ result.output }}
      {{ result.had_errors }}
      {{ result.output_errors }}
      {{ result.output_warnings }}

Valores retornados

Chave	Tipo	Retornado quando	Descrição
output	string	Sempre	Saída da execução
had_errors	boolean	Sempre	Se teve erros
output_errors	string	Sempre	erros de saída da execução
output_warnings	string	Sempre	Avisos de saída