Start-VsanClusterDiskUpdate Command | Vmware PowerCLI Reference

Start-VsanClusterDiskUpdate

This cmdlet starts the update of all vSAN disks of a cluster to the latest vSAN disk format version supported by the cluster. After the update finishes successfully, all vSAN disks in the cluster use the latest disk format version supported by the cluster. The cmdlet returns a task object that you can wait upon and query for progress.

Syntax

Start-VsanClusterDiskUpdate
-Cluster < Cluster[] >
[-AllowReducedRedundancy < Boolean > ]
[-EncryptionEnabled < Boolean > ]
[-EraseDisksBeforeUse < Boolean > ]
[-KeyProvider < KeyProvider > ]
[-ProgressAction < ActionPreference > ]
[-Server < VIServer[] > ]
[-SkipHostRemediation ]
[-SpaceEfficiencyEnabled < Boolean > ]
[CommonParameters]

Parameters

Required Parameter Name Type Position Features Description
required
Cluster Cluster[] named
  • pipeline
  • wildcards
Specifies the cluster for which you want to update all vSAN disks.
optional AllowReducedRedundancy Boolean named
This optional parameter is applicable to specific vSAN cluster reconfigure operations that need to migrate data for changing the vSAN disk format across the cluster. When specified, the process might move less data to ensure storage object accessibility, and some objects might be kept at "reduced redundancy" state, which means at a higher risk in case of a hardware failure during the migration process. The default value is $false.
optional EncryptionEnabled Boolean named
Specifies that you want to use encryption to format the disks in the cluster. The encryption configuration of the cluster does not change when you set this parameter.
optional EraseDisksBeforeUse Boolean named
Specifies whether disks should be formatted when a normal disk is converted to an encrypted disk. The encryption configuration of the cluster does not change when you set this parameter.
optional KeyProvider KeyProvider named
Specifies the key provider you want to use to format disks in the cluster. The encryption configuration of the cluster does not change when you set this parameter.
optional ProgressAction ActionPreference named
optional Server VIServer[] named
  • wildcards
Specifies the vCenter Server systems on which you want to run the cmdlet. If no value is provided or $null value is passed to this parameter, the command runs on the default servers. For more information about default servers, see the description of the Connect-VIServer cmdlet.
optional SkipHostRemediation SwitchParameter named
Indicates that host configuration remediation is skipped as part of the disk format conversion. By default, remediation runs to ensure hosts are consistent. If hosts are inconsistent, the disk format conversion prevents errors. If all hosts are already consistent and have the latest configuration, you can set the value to $true.
optional SpaceEfficiencyEnabled Boolean named
Specifies whether to activate or deactivate vSAN data efficiency from the disk format layer. This parameter is only applicable to all-flash clusters. The encryption configuration of the cluster does not change when you set this parameter.

Output

Examples

Example 1

Start-VsanClusterDiskUpdate -Cluster "vsan-cluster"

Updates the disk format of all vSAN disks in the "vsan-cluster" cluster to the latest disk format version supported by that cluster.

Related Commands

VsanCluster

This cmdlet executes vSAN cluster power on.

This cmdlet powers off a vSAN cluster.

VsanClusterConfiguration

This cmdlet retrieves vSAN related configuration data from clusters.

This cmdlet modifies vSAN configuration settings for a cluster.

VsanClusterDiskUpdate

This cmdlet starts the update of all vSAN disks of a cluster to the latest vSAN disk format version supported by the cluster.

VsanClusterHealth

This cmdlet runs a health test on the specified vSAN clusters and returns the test results.

VsanClusterPowerState

This cmdlets retrieves the power state of a vSAN cluster.

VsanClusterRebalance

This cmdlet starts the proactive rebalance of the vSAN objects on the cluster hosts based on the vSAN disks usage when the disks are in imbalanced state.

This cmdlet stops the proactive rebalance of the vSAN objects on the cluster hosts.