Remove-SCVirtualDVDDrive

  • Referência
Módulo:
VirtualMachineManager

Remove um objeto de unidade de DVD virtual do VMM.

Syntax

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 a 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 tenha 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 da 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 sua confirmação antes de executar o cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:Guid
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-JobVariable

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-OnBehalfOfUser

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:UserRole
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PROTipID

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

Type:Guid
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RunAsynchronously

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SourceBus

Especifica o barramento IDE de origem para a unidade.

Type:Byte
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-SourceLUN

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

Type:Byte
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-VirtualDVDDrive

Especifica um objeto de unidade de DVD virtual.

Type:VirtualDVDDrive
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Observações

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