Remove-SCVirtualDiskDrive

Syntax

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

Description

The Remove-SCVirtualDiskDrive cmdlet removes virtual disk drive objects from a virtual machine or from a virtual machine template in a Virtual Machine Manager (VMM) environment.

Examples

Example 1: Remove a virtual disk drive from a virtual machine

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]}

The first command gets the virtual machine object named VM01 deployed on VMHost01 by using the Get-SCVirtualMachine cmdlet. The command stores that object in the $VM variable.

The second command gets all virtual disk drive objects on VM01, and then stores the retrieved objects in $VirtDiskDrive. Using the @ symbol and parentheses makes sure that the command stores the results in an array, even if the command returns a single object or a $Null value.

The last command returns the number of virtual disk drives associated with the virtual machine and then, if more than one exists, the command removes the second virtual disk drive, designated by the [1], from the virtual machine.

Example 2: Remove all pass-through disks attached to a virtual machine

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}}

The first command gets the virtual machine object named VM02, and then stores that object in the $VM variable.

The second command gets all virtual disk drive objects attached to VM02 that are not virtual hard disks. The command gets only objects that represent pass-through disks. The command stores the pass-through disk objects in the $VDDs object array.

The last command uses an If statement to determine whether at least one pass-through virtual disk drive exists. If the result is one or more, the command then uses the ForEach statement to remove each virtual disk drive from the object array. For more information, type Get-Help about_If and Get-Help about_Foreach.

The last command specifies the Force parameter. Therefore, the command removes each virtual disk drive from its virtual machine even if other VMM objects depend on that virtual disk drive.

Example 3: Remove virtual disk drives by name

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}}}

The first command gets all virtual machine objects whose name matches the string WebSrvLOB, and then stores those objects in the $VM array.

The next two commands use the ForEach-Object cmdlet to iterate through the virtual machines stored in $VM to get all virtual disk drive objects from each virtual machine. The second command stores the virtual disk drive objects in the $VirtDiskDrives object array.

The third command uses a second ForEach loop to select all virtual disk drive objects whose name contains the string LOBData from the $VirtDiskDrives array and passes these objects to the current cmdlet. This cmdlet removes the objects from VMM.

Parameters

-Confirm

-Force

-JobGroup

-JobVariable

-OnBehalfOfUser

-OnBehalfOfUserRole

-PROTipID

-RunAsynchronously

-SkipDeleteVHD

-VirtualDiskDrive

-WhatIf

Notes

• Requires a VMM virtual disk drive object, which can be retrieved by using the Get-SCVirtualDiskDrive cmdlet.

Related Links

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