PowerCLI Reference

Set-VsanFileShare

Synopsis

This cmdlet modifies the configuration of a specified vSAN file share.

Syntax

Set-VsanFileShare [-FileShare] <VsanFileShare[]> [-Confirm] [-FileShareNetworkPermission <VsanFileShareNetworkPermission[]>] [-HardQuotaGB <Decimal>] [-SetLabel <Hashtable>] [-RemoveLabel <String[]>] [-Name <String>] [-Server <VIServer[]>] [-SoftQuotaGB <Decimal>] [-StoragePolicy <SpbmStoragePolicy>] [-WhatIf] [-Force] [<CommonParameters>]

Related Commands

Online Version
Get-VsanFileShare
New-VsanFileShare
Remove-VsanFileShare

Detailed Description

This cmdlet modifies the configuration of a specified vSAN file share.

Parameters

NameTypeDescriptionRequired?Pipeline InputDefault Value
FileShareVsanFileShare[]Specifies the list of vSAN file shares you want to update.trueTrue (ByValue)
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
FileShareNetworkPermissionVsanFileShareNetworkPermission[]Specifies the new file share network permission settings of the vSAN file share.falseFalse
ForceSwitchParameterIndicates that you want to remove the vSAN file share (for example, the file share whose ManagingEntity is the Cloud Native Storage (CNS) service).falseFalse
HardQuotaGBDecimalSpecifies the new hard quota in GB of the vSAN file share.falseFalse
NameStringSpecifies the new name of the vSAN file share.falseFalse
RemoveLabelString[]Specifies the label key that you want to remove from the vSAN file share. If a specified label key does not exist in the vSAN file share, the deletion of this label is ignored.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 the Connect-VIServer cmdlet.falseFalse
SetLabelHashtableSpecifies the newly added or updated labels of the vSAN file share. If the label key does not exist in file share, it is added with the provided value. If the label key exists in file share, the value of the key is updated.falseFalse
SoftQuotaGBDecimalSpecifies the new soft quota in GB of the vSAN file share.falseFalse
StoragePolicySpbmStoragePolicySpecifies the new storage policy of the vSAN file share.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

List of modified vSAN file share objects.

Notes

Examples

-------------------------- Example 1 --------------------------

Set-VsanFileShare -FileShare $fileShare -Name "NewName" -SoftQuotaGB 20

Renames the $fileShare vSAN file share to "NewName" and sets the soft quota to 20 GB.


Copyright © VMware, Inc. All rights reserved.