Syntax
Remove-HardDisk [-HardDisk] <HardDisk[]> [-DeletePermanently] [-WhatIf] [-Confirm] [<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.