Add-VMDvdDrive

4 min

Resumo

Parâmetros

Parâmetro	Tipo	Comentários
-AllowUnverifiedPaths	SwitchParameter	Especifica que nenhum erro deve ser lançado se o caminho especificado não for verificado como acessível pelo cluster. Este parâmetro é aplicável a máquinas virtuais em cluster.
-CimSession	CimSession	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 unidade de DVD deve ser adicionada. 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	SwitchParameter	Solicita confirmação antes de executar o cmdlet.
-ControllerLocation	integer	Especifica o número do local no controlador no qual a unidade de DVD deve ser adicionada. Se não for especificado, é usado o número do primeiro local disponível no controlador.
-ControllerNumber	integer	Especifica o número do controlador ao qual a unidade de DVD deve ser adicionada. Se não for especificado, será usado o primeiro controlador IDE no qual o ControllerLocation especificado está disponível.
-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.
-Passthru	SwitchParameter	Passa o Microsoft.HyperV.PowerShell.DvdDrive adicionado para o pipeline.
-Path	string	Especifica o caminho completo para o arquivo de disco rígido virtual ou volume de disco rígido físico para a unidade de DVD adicionada.
-ResourcePoolName	string	Especifica o nome amigável do pool de recursos ISO ao qual esta unidade de DVD deve ser associada.
-VM	string	Especifica a máquina virtual à qual a unidade de DVD deve ser adicionada.
-VMDriveController	string	Especifica o controlador de unidade ao qual a unidade de DVD deve ser adicionada.
-VMName	string	Especifica o nome da máquina virtual à qual a unidade de DVD deve ser adicionada.
-WhatIf	SwitchParameter	Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Exemplos

# Exemplo: Adicionar uma unidade de DVD virtual usando o arquivo D:\ISOs\disc1.iso à máquina virtual Test.
tasks:
  powershell_command:
    server: {{ server }}
    username: {{ username }}
    password: {{ password }}
    command: |
      Add-VMDvdDrive -VMName Test -Path D:\ISOs\disc1.iso
  register: result
- debug:
    msg: |
      {{ result.output }}
      {{ result.had_errors }}
      {{ result.output_errors }}
      {{ result.output_warnings }}

# Exemplo: Adicionar uma unidade de DVD virtual usando o controlador número 1 à máquina virtual Test.
tasks:
  powershell_command:
    server: {{ server }}
    username: {{ username }}
    password: {{ password }}
    command: |
      Get-VM Test | Add-VMDvdDrive -ControllerNumber 1
  register: result
- debug:
    msg: |
      {{ result.output }}
      {{ result.had_errors }}
      {{ result.output_errors }}
      {{ result.output_warnings }}

# Exemplo: Adicionar unidades de DVD virtuais usando os controladores IDE da máquina virtual Test.
tasks:
  powershell_command:
    server: {{ server }}
    username: {{ username }}
    password: {{ password }}
    command: |
      Get-VMIdeController -VMName Test | Add-VMDvdDrive -Path E:\
  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.