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
Parameters
| Required | Parameter Name | Type | Position | Features | Description |
|---|---|---|---|---|---|
| required
|
Cluster | Cluster[] | named |
|
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 |
|
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.