vserver cifs share properties remove

Remove from 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 remove command removes share properties from the list of share properties of an existing CIFS share. You can remove one or more share properties. You can remove additional share properties at any time by rerunning this command. Any existing share properties that you do not remove remain in effect.

Parameters

-vserver <vserver name> - Vserver
This parameter specifies the name of the Vserver containing the CIFS share whose share properties you want to remove.
-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 remove from 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. Oplocks are enabled on shares by default; 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.
  • 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.

Examples

The following example removes "showsnapshot" and "changenotify" properties to a share named "sh1".
        cluster1::> vserver cifs share properties remove -vserver vs1 -share-name sh1 -share-properties showsnapshot,changenotify