Partilhar via

Remove-SCVirtualDVDDrive

  • Referência
Módulo:
VirtualMachineManager

Remove um objeto de unidade de DVD virtual do VMM.

Sintaxe

Remove-SCVirtualDVDDrive
      [-VirtualDVDDrive] <VirtualDVDDrive>
      [-JobGroup <Guid>]
      [-RunAsynchronously]
      [-PROTipID <Guid>]
      [-JobVariable <String>]
      [-WhatIf]
      [-Confirm]
      [-OnBehalfOfUser <String>]
      [-OnBehalfOfUserRole <UserRole>]
      [<CommonParameters>]
Remove-SCVirtualDVDDrive
      -SourceBus <Byte>
      -SourceLUN <Byte>
      -JobGroup <Guid>
      [-RunAsynchronously]
      [-PROTipID <Guid>]
      [-JobVariable <String>]
      [-WhatIf]
      [-Confirm]
      [-OnBehalfOfUser <String>]
      [-OnBehalfOfUserRole <UserRole>]
      [<CommonParameters>]

Description

O cmdlet Remove-SCVirtualDVDDrive remove um ou mais objetos de unidade de DVD virtual de um perfil de hardware, uma máquina virtual ou um modelo de máquina virtual usado em um ambiente do VMM (Virtual Machine Manager). O cmdlet também exclui qualquer arquivo .iso que a unidade de DVD virtual usa do sistema de arquivos no servidor de biblioteca.

Esse cmdlet retorna o objeto após o sucesso (com a propriedade MarkedForDeletion definida como True) ou retorna uma mensagem de erro após falha.

Exemplos

Exemplo 1: remover uma unidade de DVD virtual específica de uma máquina virtual

PS C:\> $VM = Get-SCVirtualMachine -Name "VM01"
PS C:\> $DVDDrive = Get-SCVirtualDVDDrive -VM $VM | where { $_.Bus -eq 1 -and $_.LUN -eq 0 }
PS C:\> Remove-SCVirtualDVDDrive -VirtualDVDDrive $DVDDrive

O primeiro comando obtém o objeto de máquina virtual chamado VM01 e armazena o objeto na variável $VM.

O segundo comando obtém o objeto de unidade de DVD virtual localizado no primeiro slot do Canal Secundário (especificado por -Bus 1 e -LUN 0) no barramento IDE na VM01 e armazena o objeto de unidade de DVD virtual na variável $DVDDrive.

O último comando remove o objeto de unidade de DVD virtual armazenado em $DVDDrive da VM01 e exclui qualquer arquivo .iso que essa unidade de DVD virtual usa do sistema de arquivos no servidor de biblioteca.

Exemplo 2: remover a terceira unidade de DVD virtual de uma máquina virtual

PS C:\> $VM = Get-SCVirtualMachine -Name "VM02"
PS C:\> $DVDDrive = Get-SCVirtualDVDDrive -VM $VM
PS C:\> $DVDDrive[2] | Remove-SCVirtualDVDDrive

O primeiro comando obtém o objeto de máquina virtual chamado VM02 e armazena o objeto na variável $VM.

O segundo comando obtém todos os objetos de unidade de DVD virtual conectados à VM02 e armazena cada objeto de unidade de DVD virtual na matriz de objetos $DVDDrive. Este exemplo pressupõe que a VM02 tem três unidades de DVD virtual e, portanto, a matriz contém três elementos (contando de 0 a 2).

O último comando passa a terceira unidade de DVD virtual (objeto [2]) armazenada em $DVDDrive para o cmdlet Remove-SCVirtualDVDDrive, que remove esse objeto de unidade de DVD virtual do VM02 e exclui qualquer arquivo .iso usado por essa unidade de DVD virtual do sistema de arquivos no servidor de biblioteca.

Parâmetros

-Confirm

Solicita a confirmação antes de executar o cmdlet.

Tipo:SwitchParameter
Aliases:cf
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-JobGroup

Especifica um identificador para uma série de comandos que serão executados como um conjunto pouco antes do comando final que inclui o mesmo identificador de grupo de trabalho ser executado.

Tipo:Guid
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-JobVariable

Especifica que o progresso do trabalho é acompanhado e armazenado na variável nomeada por esse parâmetro.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-OnBehalfOfUser

Especifica um nome de usuário. Esse cmdlet opera em nome do usuário especificado por esse parâmetro.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-OnBehalfOfUserRole

Especifica uma função de usuário. Para obter uma função de usuário, use o cmdlet Get-SCUserRole. Esse cmdlet opera em nome da função de usuário especificada por esse parâmetro.

Tipo:UserRole
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-PROTipID

Especifica a ID da dica de Otimização de Recursos e Desempenho (dica PRO) que disparou essa ação. Esse parâmetro permite que você audite dicas pro.

Tipo:Guid
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-RunAsynchronously

Indica que o trabalho é executado de forma assíncrona para que o controle retorne ao shell de comando imediatamente.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-SourceBus

Especifica o barramento IDE de origem para a unidade.

Tipo:Byte
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-SourceLUN

Especifica o LUN (número da unidade lógica de origem) para um objeto de unidade de DVD virtual em um barramento IDE.

Tipo:Byte
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-VirtualDVDDrive

Especifica um objeto de unidade de DVD virtual.

Tipo:VirtualDVDDrive
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Tipo:SwitchParameter
Aliases:wi
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Observações

  • Requer um objeto de unidade de DVD virtual do VMM, que pode ser recuperado usando o cmdlet Get-SCVirtualDVDDrive.