Skip to main content
A newer release of this product is available.

vserver cifs share properties add

Contributors
Suggest changes

Add to the list of share properties

Availability: This command is available to cluster and Vserver administrators at the admin privilege level.

Description

The vserver cifs share properties add command adds share properties to the list of share properties of an existing CIFS share. You can add one or more share properties. You can add additional share properties at any time by rerunning this command. Any share properties that you have previously specified will remain in effect and newly added properties are appended to the existing list of share properties.

Parameters

-vserver <vserver name> - Vserver

This parameter specifies the name of the Vserver containing the CIFS share whose share properties you want to add.

-share-name <Share> - Share

This parameter specifies the name of the CIFS share.

-share-properties <share properties>,…​ - Share Properties

This parameter specifies the list of share properties you want to add to the CIFS share. The share properties can be one or more of the following:

  • oplocks - This property specifies that the share uses opportunistic locks, also known as client-side caching. This is a default initial property for all shares; however, some applications do not work well when oplocks are enabled. In particular, database applications such as Microsoft Access are vulnerable to corruption when oplocks are enabled. An advantage of shares is that a single path can be shared multiple times, with each share having different properties. For instance, if a path named /dept/finance contains both a database and other types of files, you can create two shares to it, one with oplocks disabled for safe database access and one with oplocks enabled for client-side caching.

  • browsable - This property allows Windows clients to browse the share. This is a default initial property for all shares.

  • showsnapshot - This property specifies that Snapshot copies can be viewed and traversed by clients.

  • changenotify - This property specifies that the share supports ChangeNotify requests. For shares on a Vserver with FlexVol volumes, this is a default initial property. For shares on a Vserver with Infinite Volume, the ChangeNotify property is not set by default, and setting it requires the advanced privilege level. When the ChangeNotify property is set for a share on a Vserver with Infinite Volume, change notifications are not sent for changes to file attributes and timestamps. If the path of the share is within a FlexGroup, change notifications are not sent because FlexGroups do not support ChangeNotify.

  • attributecache - This property enables the file attribute caching on the CIFS share in order to provide faster access of attributes over SMB 1.0.

    Note For certain workloads, stale file attribute data could be delivered to a client.
  • continuously-available - This property permits SMB clients that support it to open files in a persistent manner. Files opened this way are protected from disruptive events, such as failover and giveback. This option is not supported for FlexGroups, Vservers with Infinite Volume and workgroup CIFS servers.

  • branchcache - This property specifies that the share allows clients to request BranchCache hashes on the files within this share. This option is useful only if you specify "per-share" as the operating mode in the CIFS BranchCache configuration, and also specify the "oplocks" share property. This option is not supported for Vservers with Infinite Volume.

  • access-based-enumeration - This property specifies that Access Based Enumeration(ABE) is enabled on this share. ABE-filtered shared folders are visible to a user based on that individual user's access rights, preventing the display of folders or other shared resources that the user does not have rights to access.

  • namespace-caching - This property specifies that the SMB clients connecting to this share can cache the directory enumeration results returned by the CIFS servers.

  • encrypt-data - This property specifies that SMB encryption must be used when accessing this share. Clients that do not support encryption will not be able to access this share.

  • show-previous-versions - This property specifies that the previous version can be viewed and restored from the client. This property is enabled by default.

Note The oplock, browsable, changenotify and show-previous-versions share properties are assigned to a share by default. If you have removed them from a share, you can use the vserver cifs share properties add command to add these properties to the share.

Examples

The following example adds the "showsnapshot" and "changenotify" properties to a share named "sh1".

cluster1::> vserver cifs share properties add -vserver vs1 -share-name sh1 -share-properties showsnapshot,changenotify