< Back

Remove-HardDisk

Sun Jan 19, 2020 7:04 pm

NAME Remove-HardDisk



SYNOPSIS

This cmdlet removes the specified virtual hard disks.





SYNTAX

Remove-HardDisk [-HardDisk] <HardDisk[]> [-DeletePermanently] [-Confirm] [-WhatIf] [<CommonParameters>]





DESCRIPTION

This cmdlet removes the specified virtual hard disks.





PARAMETERS

-DeletePermanently [<SwitchParameter>]

Indicates that you want to delete the hard disks not only from the inventory, but from the datastore as well.



Required? false

Position? named

Default value False

Accept pipeline input? False

Accept wildcard characters? false



-HardDisk <HardDisk[]>

Specifies the hard disks you want to remove.



Required? true

Position? 1

Default value None

Accept pipeline input? True (ByValue)

Accept wildcard characters? false



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



Required? false

Position? named

Default value $true

Accept pipeline input? False

Accept wildcard characters? false



-WhatIf [<SwitchParameter>]

Indicates that the cmdlet is run only to display the changes that would be made and actually no objects are

modified.



Required? false

Position? named

Default value False

Accept pipeline input? False

Accept wildcard characters? false



<CommonParameters>

This cmdlet supports the common parameters: Verbose, Debug,

ErrorAction, ErrorVariable, WarningAction, WarningVariable,

OutBuffer, PipelineVariable, and OutVariable. For more information, see

about_CommonParameters (https:/go.microsoft.com/fwlink/?LinkID=113216).



INPUTS



OUTPUTS

None







NOTES









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



RELATED LINKS

Online Version: https://code.vmware.com/doc/preview?id= ... dDisk.html

Copy-HardDisk

Get-HardDisk

New-HardDisk

Set-HardDisk

Move-HardDisk