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

-Cluster  <Cluster[]>
[-AllowReducedRedundancy  <Boolean>]
[-EncryptionEnabled  <Boolean>]
[-EraseDisksBeforeUse  <Boolean>]
[-KeyProvider  <KmsCluster>]
[-Server  <VIServer[]>]
[-SkipHostRemediation]
[-SpaceEfficiencyEnabled  <Boolean>]
[CommonParameters]

Parameters

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

    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

    Feedback

    Was this page helpful?