Data ONTAP® PowerShell Toolkit

Switch to Data ONTAP Cluster-mode documentation.

Cmdlet: Set-NaVfilerPassword


NAME
Set-NaVfilerPassword

SYNOPSIS
Set the root password for a vfiler.

SYNTAX
Set-NaVfilerPassword [-Name] <String> [-Password] <String> [-PreserveEtcExpo
rts] [-PreserveEtcHosts] [-Controller <NaController>] [-WhatIf] [-Confirm] [
<CommonParameters>]

Set-NaVfilerPassword [-Name] <String> -Credential <PSCredential> [-PreserveE
tcExports] [-PreserveEtcHosts] [-Controller <NaController>] [-WhatIf] [-Conf
irm] [<CommonParameters>]


DESCRIPTION
Set the root password for a vfiler.


PARAMETERS
-Name <String>
The name of the vfiler.

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

-Password <String>
The new root password.

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

-PreserveEtcExports
This cmdlet uses the vfiler-setup API which will re-write the vfiler's /
etc/exports file. Sometimes, this behavior is not desirable. Use this
switch to automatically restore the contents of the /etc/exports file on
ce the command completes.

If this parameter is not specified, the vfiler's /etc/exports file can s
till be restored manually from the /etc/exports.bak backup.

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

-PreserveEtcHosts
This cmdlet uses the vfiler-setup API which will re-write the vfiler's /
etc/hosts file. Sometimes, this behavior is not desirable. Use this sw
itch to automatically restore the contents of the /etc/hosts file once t
he command completes.

If this parameter is not specified, the vfiler's /etc/hosts file can sti
ll be restored manually from the /etc/hosts.bak backup.

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

-Credential <PSCredential>
Credential containing new root password for the vfiler.

Required? true
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
DataONTAP.Types.Vfiler.VfilerInfo


NOTES


Category: vfiler
API: vfiler-setup

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

C:\PS>Set-NaVfilerPassword vfiler2 tricky


Set the root password of vfiler 'vfiler2'.


Name Status Ipspace #Vfnets #Vfstores AdminHost
---- ------ ------- ------- --------- ---------
vfiler2 running default-ipspace 3 1 x3550rre7



RELATED LINKS
Get-NaVfiler







 Data ONTAP® PowerShell Toolkit