New-VHD

4 min

Resumo

Cria um ou mais discos rígidos virtuais novos.

Parâmetros

Parâmetro	Tipo	Comentários
-AsJob	string	Executa o cmdlet como um trabalho em segundo plano.
-BlockSizeBytes	string	specifica o tamanho do bloco, em bytes, do disco rígido virtual a ser criado.
-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.
-Differencing	string	Especifica que um disco rígido virtual diferencial deve ser criado.
-Dynamic	string	Especifica que um disco rígido virtual dinâmico deve ser criado.
-Fixed	string	Especifica que um disco rígido virtual fixo deve ser criado.
-LogicalSectorSizeBytes	string	Especifica o tamanho do setor lógico, em bytes, do disco rígido virtual a ser criado. Os valores válidos são 512 e 4096.
-ParentPath	string	Especifica o caminho para o pai do disco diferencial a ser criado (este parâmetro pode ser especificado apenas para a criação de um disco diferencial).
-Path	string	Caminho para os novos arquivos de disco rígido virtual que estão sendo criados como resultado de um comando. Se um nome de arquivo ou caminho relativo for especificado, o novo caminho do disco rígido virtual será calculado em relação ao diretório de trabalho atual.
-PhysicalSectorSizeBytes	string	Especifica o tamanho do setor físico, em bytes. Os valores válidos são 512 e 4096.
-SizeBytes	string	O tamanho máximo, em bytes, do disco rígido virtual a ser criado.
-SourceDisk	string	Especifica o disco físico a ser usado como origem do disco rígido virtual a ser criado.
-WhatIf	string	Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Exemplos

# Exemplo: Este exemplo cria um disco rígido virtual dinâmico no formato VHDX com 10 GB de tamanho. A extensão do nome do arquivo determina o formato e o tipo padrão de dinâmico é usado porque nenhum tipo é especificado.
tasks:
  powershell_command:
    server: {{ server }}
    username: {{ username }}
    password: {{ password }}
    command: |
      New-VHD -Path c:\Base.vhdx -SizeBytes 10GB
  register: result
- debug:
    msg: |
      {{ result.output }}
      {{ result.had_errors }}
      {{ result.output_errors }}
      {{ result.output_warnings }}

# Exemplo: Este exemplo cria um disco rígido virtual diferenciador de formato VHDX com um caminho pai de c:\Base.vhdx.
tasks:
  powershell_command:
    server: {{ server }}
    username: {{ username }}
    password: {{ password }}
    command: |
      New-VHD -ParentPath c:\Base.vhdx -Path c:\Diff.vhdx -Differencing
  register: result
- debug:
    msg: |
      {{ result.output }}
      {{ result.had_errors }}
      {{ result.output_errors }}
      {{ result.output_warnings }}

# Exemplo: Este exemplo cria um disco rígido virtual fixo no formato VHD de 1 TB no caminho 
# especificado. Os dados do disco rígido virtual são preenchidos a partir do disco 
# identificado no sistema pelo número 2. Você pode listar os discos conectados ao sistema 
# e o número associado a cada disco usando o cmdlet Get-Disk .
tasks:
  powershell_command:
    server: {{ server }}
    username: {{ username }}
    password: {{ password }}
    command: |
      New-VHD -Path C:\fixed.vhd -Fixed -SourceDisk 2 -SizeBytes 1TB
  register: result
- debug:
    msg: |
      {{ result.output }}
      {{ result.had_errors }}
      {{ result.output_errors }}
      {{ result.output_warnings }}

# Exemplo: Este exemplo cria um novo disco rígido virtual dinâmico no formato VHDX de 1 TB 
# no caminho especificado com um tamanho de bloco de 128 MB e um tamanho de setor 
# lógico de 4 KB.
tasks:
  powershell_command:
    server: {{ server }}
    username: {{ username }}
    password: {{ password }}
    command: |
      New-VHD -Path c:\LargeSectorBlockSize.vhdx -BlockSizeBytes 128MB -LogicalSectorSize 4KB -SizeBytes 1TB
  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