Data ONTAP® PowerShell Toolkit

Switch to Data ONTAP 7-mode documentation.

Cmdlet: New-NcActiveDirectoryAccount


NAME
New-NcActiveDirectoryAccount

SYNOPSIS
Create an Active Directory account for the given Vserver.

SYNTAX
New-NcActiveDirectoryAccount [-Name] <String> [-Domain] <String> [-AdminCred
ential] <PSCredential> [-OrganizationalUnit <String>] [-Force] [-VserverCont
ext <String>] [-Controller <NcController[]>] [<CommonParameters>]


DESCRIPTION
Create an Active Directory account for the given Vserver. If a CIFS server a
lready exists for the requested Vserver, then this command will fail. The ex
isting CIFS server should be deleted before retrying again.


PARAMETERS
-Name <String>
Active Directory account NetBIOS name.

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

-Domain <String>
Fully qualified domain name.

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

-AdminCredential <PSCredential>
Administrator credential required for Active Directory account creation.

Required? true
Position? 3
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false

-OrganizationalUnit <String>
Organizational unit under which the Active Directory account will be cre
ated.

Required? false
Position? named
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false

-Force
If specified and a machine account with the same name as specified by Na
me exists in Active Directory, it will be overwritten and reused.

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

-VserverContext <String>
Vserver to which to direct this command. If the currently connected con
troller (as embodied by an NcController object) represents a cluster, th
ere are multiple means to address commands to one of its vservers. Eith
er set the Vserver field on the NcController object to direct all subseq
uent commands to that vserver, or supply the VserverContext parameter to
an individual cmdlet. Only cmdlets which may be invoked on vservers of
fer the VserverContext parameter.

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

-Controller <NcController[]>
A clustered Data ONTAP controller to receive this cmdlet, as embodied by
an NcController object. This parameter is returned by the Connect-NcCo
ntroller cmdlet. If not specified, the value in the global variable Cur
rentNcController is used. In the latter case, if CurrentNcController co
ntains a collection of NcController objects, this cmdlet is invoked on e
ach controller in succession.

Required? false
Position? named
Default value
Accept pipeline input? true (ByValue, ByPropertyName)
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.C.Types.ActiveDirectory.ActiveDirectoryAccountConfig


NOTES


Category: active directory
API: active-directory-account-create
Family: vserver

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

C:\PS>New-NcActiveDirectoryAccount -Name TEST01 -Domain rtprre.testdomain -A
dminCredential Administrator


Add a TEST01 account to the rtprre.testdomain domain.


AccountName Domain DomainWorkgrou
p Vserver
----------- ------ --------------
- -------
TEST01 RTPRRE.TESTDOMAIN RTPRRE
beam_vsim01



RELATED LINKS
Get-NcActiveDirectoryAccount
Remove-NcActiveDirectoryAccount
Set-NcActiveDirectoryAccount







 Data ONTAP® PowerShell Toolkit