NAME

New-HPOVLdap

SYNOPSIS

Add a new Directory for Authentication.

SYNTAX

New-HPOVLdap [-Name] <String> -AD [-RootDN] <String> [-SearchContext] <String> [-Servers] <Array> [-Username] <String> [-Password] <SecureString> [<CommonParameters>] [<CommonParameters>]

New-HPOVLdap [-Name] <String> -LDAP [-RootDN] <String> [-SearchContext] <String> [-Servers] <Array> [-Username] <String> [-Password] <SecureString> [<CommonParameters>]

DESCRIPTION

This cmdlet will create a new Directory for appliance authentication.  HP OneView currently supports either Active Directory or LDAP (e.g. OpenLDAP) for user authentication.  The New-HPOVLdapServer cmdlet is used to assist defining directory servers address, public SSL certificate and LDAP over SSL TCP port.

PARAMETERS

-Name <String>
Directory name to add.  Does not need to match LDAP/AD Directory Name, but should.
Required? true
Position? 1
Default value <none>            
Accept pipeline input? false
Accept wildcard characters?   false
-AD [<SwitchParameter>]
Using Active Directory, which sets the authProtocol to AD and userNameField to CN.
Required? true
Position? named
Default value False               
Accept pipeline input? false
Accept wildcard characters?   false
-LDAP [<SwitchParameter>]
Using LDAP (i.e. OpenLDAP), which sets the authProtocol to LDAP and userNameField to UID
Required? true
Position? named
Default value False               
Accept pipeline input? false
Accept wildcard characters?    false

-RootDN <String>
Alias ['root']

Directory Base DN (E.g. dc=domian,dc=local)

Required? true
Position? 4
Default value <none>            
Accept pipeline input? false
Accept wildcard characters? false
-SearchContext <String>

Search context to begin search for Directory Group and User Account authentication.
E.g. ou=admins,ou=contoso

Starting with HP OneView 1.01, up to 4 search contexts can be specified seperated with the + (plus) character.
E.g. ou=admins,ou=contoso+ou=admingroups,ou=contoso

Required? true
Position? 4
Default value <none>            
Accept pipeline input? false
Accept wildcard characters? false
-Servers <Array>

Array of Directory Servers and their settings.  Must include the following:

  • Server Name (FQDN or IP)
  • Public SSL Certificate
  • SSL Port, if not default 636
Required? true
Position? 5
Default value <none>            
Accept pipeline input? false
Accept wildcard characters?   false

-Username <String>
Alias ['u','user']

Directory Username to authenticate with.

Required? true
Position? 6
Default value <none>            
Accept pipeline input? false
Accept wildcard characters?   false

-Password <SecureString>
Alias ['p', 'pass']

Directory Username password.

Required? true
Position? 7
Default value  
Accept pipeline input? true (ByValue) 
Accept wildcard characters?    false


<CommonParameters>

This cmdlet supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, WarningVariable, OutBuffer, PipelineVariable, and OutVariable. For more information, see about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216).

INPUTS

System.Security.SecureString

OUTPUTS

System.String

RELATED LINKS

EXAMPLES

-------------------------- EXAMPLE 1 --------------------------

PS C:\ $ServerA = New-HPOVLdapServer -Name servera.domain.com -Certificate C:\dir\servera.cer
PS C:\ $ServerB = New-HPOVLdapServer -Name serverb.domain.com -Certificate C:\dir\serverb.cer
PS C:\ New-HPOVLdap -name Domain1 -AD -rootdn 'dc=domain,dc=com' -SearchContext 'ou=admins,ou=contoso' –servers @($ServerA,$ServerB)

Add a new directory with two directory servers.
-------------------------- EXAMPLE 2 --------------------------

PS C:\ $ServerA = New-HPOVLdapServer -Name servera.domain.com -Certificate C:\dir\servera.cer
PS C:\ $ServerB = New-HPOVLdapServer -Name serverb.domain.com -Certificate C:\dir\serverb.cer
PS C:\> $password = ConvertTo-SecureString -asplaintext "password123890" -force
PS C:\> New-HPOVLdap -name Domain1 -AD -rootdn 'dc=domain,dc=com' -SearchContext 'ou=admins,ou=contoso+ou=groups,ou=contoso' -servers @($ServerA,$ServerB) -user Administrator -password $password

Create and validate a new Directory with multiple Search Contexts.

Last edited Jan 29, 2014 at 11:04 PM by ChrisLynchHP, version 3