Syntax
Format-VMHostDiskPartition [-VolumeName] <String> -VMHostDiskPartition <VMHostDiskPartition[]> [-WhatIf] [-Confirm] [<CommonParameters>]Related Commands
Online versionDetailed Description
This cmdlet formats a new VMFS (Virtual Machine File System) on each of the specified host disk partitions.Parameters
Name | Type | Description | Required? | Pipeline Input | Default Value |
---|---|---|---|---|---|
VolumeName | String | Specifies a name for the new VMFS. | true | 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. | false | false | |
VMHostDiskPartition | VMHostDiskPartition[] | Specifies the disk partitions on which you want to format a new VMFS. | true | true (ByValue) | |
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
Zero or more formatted VMHostDiskPartition objectsNotes
Examples
-------------- Example 1 --------------
Get-VMHost Host | Get-VMHostDisk | Get-VMHostDiskPartition | ? {.Type -eq "Ntfs"} | Format-VMHostDiskPartition -VolumeName "NewStorage"
Formats the NTFS disk partitions of a host.