Data ONTAP® PowerShell Toolkit

Switch to Data ONTAP Cluster-mode documentation.

Cmdlet: Set-NaCifsHomeDirectory


NAME
Set-NaCifsHomeDirectory

SYNOPSIS
Provides a list of CIFS home directory paths for the controller.

SYNTAX
Set-NaCifsHomeDirectory [-Paths] <String[]> [-Force] [-Controller <NaControl
ler>] [-WhatIf] [-Confirm] [<CommonParameters>]


DESCRIPTION
Provides a list of CIFS home directory paths for the controller. Replaces th
e current list of paths in use by the controller. Note that supplying an emp
ty path list causes controller to delete any current entries.


PARAMETERS
-Paths <String[]>
An array, one entry per each CIFS home directory path.

Required? true
Position? 1
Default value
Accept pipeline input? true (ByValue, ByPropertyName)
Accept wildcard characters? false

-Force
If true, the new set of homedir paths will be put into use even if some
user homedir connections will be broken. This can cause users with open
files in their home directories to lose access to the files. A user can
lose data if there are updates not yet committed to disk.

Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false

-Controller <NaController>
The Data ONTAP controller object, embodied by an NaController object. T
his parameter is returned by the Connect-NaController cmdlet. If not sp
ecified, the value in the global variable CurrentNaController is used.

Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false

-WhatIf


Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false

-Confirm


Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false

<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer and OutVariable. For more information, type,
"get-help about_commonparameters".

INPUTS



OUTPUTS
NetApp.Ontapi.Filer.Cifs.PathErrorInfo


NOTES


Category: cifs
API: cifs-homedir-paths-set

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

C:\PS>Set-NaCifsHomeDirectory "/vol/vol0/user1","/vol/vol0/user2","/vol/vol0
/user3"


Set the home directories for three users (one of which doesn't exist).


ErrorPath ErrorPathDesc
--------- -------------
/vol/vol0/user3 Homedir path doesn't exist, discardi
...


-------------- Example 2 --------------

C:\PS>Set-NaCifsHomeDirectory @()


Removes all CIFS home directories.






RELATED LINKS
Get-NaCifsHomeDirectory







 Data ONTAP® PowerShell Toolkit