< Back

Format-VMHostDiskPartition

Sun Jan 19, 2020 6:48 pm

NAME Format-VMHostDiskPartition



SYNOPSIS

This cmdlet formats a new VMFS (Virtual Machine File System) on each of the specified host disk partitions.





SYNTAX

Format-VMHostDiskPartition [-VolumeName] <String> -VMHostDiskPartition <VMHostDiskPartition[]> [-Confirm]

[-WhatIf] [<CommonParameters>]





DESCRIPTION

This cmdlet formats a new VMFS (Virtual Machine File System) on each of the specified host disk partitions.





PARAMETERS

-VMHostDiskPartition <VMHostDiskPartition[]>

Specifies the disk partitions on which you want to format a new VMFS.



Required? true

Position? named

Default value None

Accept pipeline input? True (ByValue)

Accept wildcard characters? false



-VolumeName <String>

Specifies a name for the new VMFS.



Required? true

Position? 1

Default value None

Accept pipeline input? False

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 False

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

Zero or more formatted VMHostDiskPartition objects







NOTES









-------------------------- Example 1 --------------------------



Get-VMHost Host | Get-VMHostDisk | Get-VMHostDiskPartition | ? {.Type -eq "Ntfs"} | Format-VMHostDiskPartition

-VolumeName "NewStorage"



Formats the NTFS disk partitions of a host.



RELATED LINKS

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

Get-VMHostDiskPartition