Remove-SCVirtualDiskDrive

Syntax

Remove-SCVirtualDiskDrive
      [-VirtualDiskDrive] <VirtualDiskDrive>
      [-SkipDeleteVHD]
      [-JobGroup <Guid>]
      [-Force]
      [-RunAsynchronously]
      [-PROTipID <Guid>]
      [-JobVariable <String>]
      [-WhatIf]
      [-Confirm]
      [-OnBehalfOfUser <String>]
      [-OnBehalfOfUserRole <UserRole>]
      [<CommonParameters>]

Description

O cmdlet Remove-SCVirtualDiskDrive remove objetos de unidade de disco virtual de uma máquina virtual ou de um modelo de máquina virtual em um ambiente do VMM (Virtual Machine Manager).

Exemplos

Exemplo 1: remover uma unidade de disco virtual de uma máquina virtual

PS C:\> $VM = Get-SCVirtualMachine | Where-Object { $_.VMHost.Name -Eq "VMHost01.Contoso.com" -And $_.Name -Eq "VM01" }
PS C:\> $VirtDiskDrive = @(Get-SCVirtualDiskDrive -VM $VM)
PS C:\> If($VirtDiskDrive.Count -Gt 1){Remove-SCVirtualDiskDrive -VirtualDiskDrive $VirtDiskDrive[1]}

O primeiro comando obtém o objeto de máquina virtual chamado VM01 implantado em VMHost01 usando o cmdlet Get-SCVirtualMachine . O comando armazena esse objeto na variável $VM.

O segundo comando obtém todos os objetos de unidade de disco virtual na VM01 e armazena os objetos recuperados em $VirtDiskDrive. Usar o símbolo @ e parênteses garante que o comando armazene os resultados em uma matriz, mesmo que o comando retorne um único objeto ou um valor $Null.

O último comando retorna o número de unidades de disco virtual associadas à máquina virtual e, se houver mais de uma, o comando removerá a segunda unidade de disco virtual, designada pelo [1], da máquina virtual.

Exemplo 2: remover todos os discos de passagem anexados a uma máquina virtual

PS C:\> $VM = Get-SCVirtualMachine | Where-Object {$_.Name -Eq "VM02"}
PS C:\> $VirtDiskDrives = @(Get-SCVirtualDiskDrive -VM $VM | Where-Object {$_.IsVHD -Eq $False})
PS C:\> If($VirtDiskDrives.Count -Gt 0){ForEach($VirtDiskDrive in $VirtDiskDrives){Remove-SCVirtualDiskDrive -Force -VirtualDiskDrive $VirtDiskDrive}}

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

O segundo comando obtém todos os objetos de unidade de disco virtual anexados à VM02 que não são discos rígidos virtuais. O comando obtém apenas objetos que representam discos de passagem. O comando armazena os objetos de disco de passagem na matriz de objetos $VDDs.

O último comando usa uma instrução If para determinar se existe pelo menos uma unidade de disco virtual de passagem. Se o resultado for um ou mais, o comando usará a instrução ForEach para remover cada unidade de disco virtual da matriz de objetos. Para obter mais informações, digite Get-Help about_If e Get-Help about_Foreach.

O último comando especifica o parâmetro Force . Portanto, o comando remove cada unidade de disco virtual de sua máquina virtual, mesmo que outros objetos do VMM dependam dessa unidade de disco virtual.

Exemplo 3: remover unidades de disco virtual por nome

PS C:\> $VM = @(Get-SCVirtualMachine | Where-Object {$_.Name -Match "WebSrvLOB"})
PS C:\> ForEach-Object ($VM in $VMs){$VirtDiskDrives = Get-SCVirtualDiskDrive -VM $VM 
PS C:\> ForEach-Object ($VirtDiskDrive in $VirtDiskDrives){If($VirtDiskDrive.Name -Match "LOBData"){Remove-SCVirtualDiskDrive -VirtualDiskDrive $VirtDiskDrive}}}

O primeiro comando obtém todos os objetos de máquina virtual cujo nome corresponde à cadeia de caracteres WebSrvLOB e armazena esses objetos na matriz $VM.

Os dois comandos seguintes usam o cmdlet ForEach-Object para iterar por meio das máquinas virtuais armazenadas em $VM para obter todos os objetos de unidade de disco virtual de cada máquina virtual. O segundo comando armazena os objetos de unidade de disco virtual na matriz de objetos $VirtDiskDrives.

O terceiro comando usa um segundo loop ForEach para selecionar todos os objetos de unidade de disco virtual cujo nome contém a cadeia de caracteres LOBData da matriz $VirtDiskDrives e passa esses objetos para o cmdlet atual. Esse cmdlet remove os objetos do VMM.

Parâmetros

-Confirm

-Force

-JobGroup

-JobVariable

-OnBehalfOfUser

-OnBehalfOfUserRole

-PROTipID

-RunAsynchronously

-SkipDeleteVHD

-VirtualDiskDrive

-WhatIf

Observações

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

Links Relacionados

• Compress-SCVirtualDiskDrive
• Convert-SCVirtualDiskDrive
• Expand-SCVirtualDiskDrive
• Get-SCVirtualDiskDrive
• Get-SCVirtualMachine
• New-SCVirtualDiskDrive
• Set-SCVirtualDiskDrive
• Test-SCVirtualDiskDrive