Syntax
Remove-HardDisk [-HardDisk] <HardDisk[]> [-DeletePermanently] [-Confirm] [-WhatIf] [<CommonParameters>]Related Commands
Online VersionDetailed Description
This cmdlet removes the specified virtual hard disks.Parameters
| Name | Type | Description | Required? | Pipeline Input | Default Value |
|---|---|---|---|---|---|
| HardDisk | HardDisk[] | Specifies the hard disks you want to remove. | true | True (ByValue) | |
| Confirm | SwitchParameter | If the value is $true, indicates that the cmdlet asks for confirmation before running. If the value is $false, the cmdlet runs without asking for user confirmation. | false | False | |
| DeletePermanently | SwitchParameter | Indicates that you want to delete the hard disks not only from the inventory, but from the datastore as well. | false | False | |
| WhatIf | SwitchParameter | Indicates that the cmdlet is run only to display the changes that would be made and actually no objects are modified. | false | False |
Return Type
NoneNotes
Examples
-------------------------- Example 1 --------------------------
Get-HardDisk -VM $vm | Remove-HardDisk
Removes the hard disks of the virtual machine stored in the $vm variable.
-------------------------- Example 2 --------------------------
$hdd = Get-HardDisk -VM 'MyVM' -Name 'Hard disk 4' Remove-HardDisk -HardDisk $hdd
Removes the 'Hard disk 4' hard disk of the 'MyVM' virtual machine.