< Back
Start-VsanClusterDiskUpdate
Post
NAME 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>]
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
-AllowReducedRedundancy <Boolean>
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.
Required? false
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-Cluster <Cluster[]>
Specifies the cluster for which you want to update all vSAN disks.
Required? true
Position? 1
Default value None
Accept pipeline input? True (ByValue)
Accept wildcard characters? true
-EncryptionEnabled <Boolean>
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.
Required? false
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-EraseDisksBeforeUse <Boolean>
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.
Required? false
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-KmsCluster <KmsCluster>
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.
Required? false
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-Server <VIServer[]>
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.
Required? false
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? true
-SkipHostRemediation [<SwitchParameter>]
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.
Required? false
Position? named
Default value False
Accept pipeline input? False
Accept wildcard characters? false
-SpaceEfficiencyEnabled <Boolean>
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.
Required? false
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? 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.
Required? false
Position? named
Default value False
Accept pipeline input? False
Accept wildcard characters? false
-WhatIf [<SwitchParameter>]
Indicates that the cmdlet is run only to display the changes that would be made and actually no objects are
modified.
Required? false
Position? named
Default value False
Accept pipeline input? False
Accept wildcard characters? false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (https:/go.microsoft.com/fwlink/?LinkID=113216).
INPUTS
OUTPUTS
The task objects to track the operations in the cluster
NOTES
-------------------------- 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 LINKS
Online Version: https://code.vmware.com/doc/preview?id= ... pdate.html
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>]
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
-AllowReducedRedundancy <Boolean>
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.
Required? false
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-Cluster <Cluster[]>
Specifies the cluster for which you want to update all vSAN disks.
Required? true
Position? 1
Default value None
Accept pipeline input? True (ByValue)
Accept wildcard characters? true
-EncryptionEnabled <Boolean>
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.
Required? false
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-EraseDisksBeforeUse <Boolean>
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.
Required? false
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-KmsCluster <KmsCluster>
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.
Required? false
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-Server <VIServer[]>
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.
Required? false
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? true
-SkipHostRemediation [<SwitchParameter>]
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.
Required? false
Position? named
Default value False
Accept pipeline input? False
Accept wildcard characters? false
-SpaceEfficiencyEnabled <Boolean>
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.
Required? false
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? 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.
Required? false
Position? named
Default value False
Accept pipeline input? False
Accept wildcard characters? false
-WhatIf [<SwitchParameter>]
Indicates that the cmdlet is run only to display the changes that would be made and actually no objects are
modified.
Required? false
Position? named
Default value False
Accept pipeline input? False
Accept wildcard characters? false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (https:/go.microsoft.com/fwlink/?LinkID=113216).
INPUTS
OUTPUTS
The task objects to track the operations in the cluster
NOTES
-------------------------- 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 LINKS
Online Version: https://code.vmware.com/doc/preview?id= ... pdate.html