PowerCLI Reference

Start-VsanClusterDiskUpdate

Synopsis

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

Syntax

Start-VsanClusterDiskUpdate [-Cluster] <Cluster[]> [-AllowReducedRedundancy <Boolean>] [-EncryptionEnabled <Boolean>] [-EraseDisksBeforeUse <Boolean>] [-KmsCluster <KmsCluster>] [-Server <VIServer[]>] [-SkipHostRemediation] [-SpaceEfficiencyEnabled <Boolean>] [-Confirm] [-WhatIf] [<CommonParameters>]

Related Commands

Online Version

Detailed Description

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.

Parameters

NameTypeDescriptionRequired?Pipeline InputDefault Value
ClusterCluster[]Specifies the cluster for which you want to update all vSAN disks.trueTrue (ByValue)
AllowReducedRedundancyBooleanThis 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.falseFalse
ConfirmSwitchParameterIf 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.falseFalse
EncryptionEnabledBooleanSpecifies 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.falseFalse
EraseDisksBeforeUseBooleanSpecifies 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.falseFalse
KmsClusterKmsClusterSpecifies 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.falseFalse
ServerVIServer[]Specifies the vCenter Server systems on which you want to run the cmdlet. If no value is given to this parameter, the command runs on the default servers. For more information about default servers, see the description of Connect-VIServer.falseFalse
SkipHostRemediationSwitchParameterIndicates 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.falseFalse
SpaceEfficiencyEnabledBooleanSpecifies whether to enable or disable 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.falseFalse
WhatIfSwitchParameterIndicates that the cmdlet is run only to display the changes that would be made and actually no objects are modified.falseFalse

Return Type

The task objects to track the operations in the cluster

Notes

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.


Copyright © VMware, Inc. All rights reserved.