Partilhar via

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 condução de DVD virtuais de um perfil de hardware, uma máquina virtual ou um modelo de máquina virtual usado num ambiente virtual de Gestor de Máquinas (VMM). O cmdlet também elimina qualquer ficheiro .iso que a unidade virtual de DVD utiliza a partir do sistema de ficheiros no servidor da biblioteca.

Este cmdlet devolve o objeto após o sucesso (com a propriedade marcada para a Entrega de Imagem definida para Verdadeiro) ou devolve 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 recebe o objeto da máquina virtual chamado VM01 e armazena o objeto na variável $VM.

O segundo comando obtém o objeto de unidade dvd virtual localizado na primeira ranhura do Canal Secundário (especificado por -Bus 1 e -LUN 0) no autocarro IDE em VM01 e, em seguida, armazena o objeto de unidade virtual de DVD na variável $DVDDrive.

O último comando remove o objeto de unidade virtual de DVD armazenado em $DVDDrive do VM01 e elimina qualquer ficheiro .iso que esta unidade virtual de DVD utiliza do sistema de ficheiros no servidor da biblioteca.

Exemplo 2: Remover a terceira unidade virtual de DVD 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 da 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 virtuais ligados ao VM02 e armazena cada objeto de unidade de DVD virtual na matriz de objetos $DVDDrive. Este exemplo pressupõe que o VM02 tem três unidades de DVD virtuais e, portanto, a matriz contém três elementos (contando 0 a 2).

O último comando passa a terceira unidade virtual de DVD (objeto [2]) armazenada em $DVDDrive para o cmdlet Remove-SCVirtualDVDDrive , que remove este objeto de unidade de DVD virtual do VM02 e elimina qualquer ficheiro .iso utilizado por este dvd virtual do sistema de ficheiros no servidor da biblioteca.

Parâmetros

-Confirm

Solicita a 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 funcionarão como um conjunto pouco antes do comando final que inclui o mesmo identificador do grupo de trabalho.

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

-JobVariable

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

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

-OnBehalfOfUser

Especifica um nome de utilizador. Este cmdlet funciona em nome do utilizador que este parâmetro especifica.

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

-OnBehalfOfUserRole

Especifica uma função de utilizador. Para obter uma função de utilizador, utilize o cmdlet Get-SCUserRole . Este cmdlet funciona em nome da função de utilizador que este parâmetro especifica.

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

-PROTipID

Especifica o ID da ponta de otimização de desempenho e recursos (ponta PRO) que desencadeou esta ação. Este parâmetro permite-lhe auditar dicas PRO.

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

-RunAsynchronously

Indica que o trabalho funciona assíncronamente para que o controlo volte imediatamente à concha de comando.

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

-SourceBus

Especifica o ônibus 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 número da unidade lógica de origem (LUN) para um objeto de unidade de DVD virtual num autocarro 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

Apresenta o que aconteceria mediante a execução do cmdlet. O cmdlet não é executado.

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

Notas

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