New HPOVLdapGroup

Library Version 3.10

Library Version 3.00

Library Version 2.00

Library Version 1.20

HPE OneView 3.10 Library

New-HPOVLdapGroup

Add a new Directory Group to appliance.

SYNTAX

New-HPOVLdapGroup [-Directory] <Object> [-Group] <Object> [-Roles] <Array> [-Username] <String>[ [-Password] <Object>][ [-ApplianceConnection] <Object>] [<CommonParameters>]

Detailed Description

This cmdlet provides the ability to add a new Directory Group to the appliance. You can use the Show-HPOVLdapGroups to retrieve a list of avialable Directory Groups from the specified Directory.

Parameters

-ApplianceConnection <Object>

Aliases [-Appliance]

Specify one or more HPOneView.Appliance.Connection object(s) or Name property value(s).

Default Value: ${Global:ConnectedSessions} | ? Default

Aliases	Appliance
Required?	false
Position?	named
Default value	(${Global:ConnectedSessions} | ? Default)
Accept pipeline input?	false
Accept wildcard characters?	False

-Directory <Object>

Aliases [-d, -domain, -AuthProvider] LDAP/Active Directory Domain object.

Aliases	d, domain, authProvider
Required?	true
Position?	named
Default value
Accept pipeline input?	true (ByValue)
Accept wildcard characters?	False

-Group <Object>

Aliases [-g, -GroupName, -name] Directroy Group to add. Can either be a string value of a Cononical Name of directory group, or object from Show-HPOVLdapGroups.

Aliases	g, GroupName, name
Required?	true
Position?	named
Default value
Accept pipeline input?	false
Accept wildcard characters?	False

-Password <Object>

Aliases [-p] Directory User account password. Can be System.String or SecureString object.

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

-Roles <Array>

Aliases [-r, -role] The role(s) to assign to the Directroy Group, in System.Collections.ArrayList format. Accepted values are:

* Read only
* Infrastructure administrator
* Server administrator
* Storage administrator
* Network administrator
* Backup administrator

e.g. $roles = "Server administrator","Network administrator"

Aliases	r, role
Required?	true
Position?	named
Default value
Accept pipeline input?	false
Accept wildcard characters?	False

-Username <String>

Aliases [-u] Directory Username to authenticate with

Aliases	u
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, PipelineVariable, and OutVariable. For more information, see about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216)

Input Types

System.SecureString

Directory User Account password

Return Values

System.Management.Automation.PSCustomObject

New LDAP Group object with role assignment(s)

Examples

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

New-HPOVLdapGroup -d Domain1 -GroupName "MY Directory Group1" -roles @("Server administrator") -u 'Sarah Peterson'

Add "MY Directory Group1" from Domain1 with Server Administrator role and prompt for password for group validation.

 -------------------------- EXAMPLE 2 --------------------------

$roles = "Server administrator","Backup administrator"
$password = convertto-securestring -asplaintext "password123890" -force
New-HPOVLdapGroup -d Domain1 -GroupName "MY Directory Group1" -roles $roles -u 'Sarah Peterson' -p $password

Add "MY Directory Group1" from Domain1 with Server and Backup administrator roles, and specify password for group validation.

Related Links

• Show-HPOVLdapGroups
• Get-HPOVLdapGroup
• Remove-HPOVLdapGroup
• Set-HPOVLdapGroupRole
• Get-HPOVLdapDirectory
• New-HPOVLdapDirectory

---

Top

HPE OneView 3.00 Library

New-HPOVLdapGroup

Add a new Directory Group to appliance.

SYNTAX

New-HPOVLdapGroup [-Directory] <Object> [-Group] <Object> [-Roles] <Array> [-Username] <String>[ [-Password] <Object>][ [-ApplianceConnection] <Object>] [<CommonParameters>]

Detailed Description

This cmdlet provides the ability to add a new Directory Group to the appliance. You can use the Show-HPOVLdapGroups to retrieve a list of avialable Directory Groups from the specified Directory.

Parameters

-ApplianceConnection <Object>

Aliases [-Appliance]

Specify one or more HPOneView.Appliance.Connection object(s) or Name property value(s).

Default Value: ${Global:ConnectedSessions} | ? Default

Aliases	Appliance
Required?	false
Position?	named
Default value	(${Global:ConnectedSessions} | ? Default)
Accept pipeline input?	false
Accept wildcard characters?	False

-Directory <Object>

Aliases [-d, -domain, -AuthProvider] LDAP/Active Directory Domain object.

Aliases	d, domain, authProvider
Required?	true
Position?	named
Default value
Accept pipeline input?	true (ByValue)
Accept wildcard characters?	False

-Group <Object>

Aliases [-g, -GroupName, -name] Directroy Group to add. Can either be a string value of a Cononical Name of directory group, or object from Show-HPOVLdapGroups.

Aliases	g, GroupName, name
Required?	true
Position?	named
Default value
Accept pipeline input?	false
Accept wildcard characters?	False

-Password <Object>

Aliases [-p] Directory User account password. Can be System.String or SecureString object.

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

-Roles <Array>

Aliases [-r, -role] The role(s) to assign to the Directroy Group, in System.Collections.ArrayList format. Accepted values are:

• Read only
• Infrastructure administrator
• Server administrator
• Storage administrator
• Network administrator
• Backup administrator

e.g. $roles = "Server administrator","Network administrator"

Aliases	r, role
Required?	true
Position?	named
Default value
Accept pipeline input?	false
Accept wildcard characters?	False

-Username <String>

Aliases [-u] Directory Username to authenticate with

Aliases	u
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, PipelineVariable, and OutVariable. For more information, see about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216)

Input Types

System.SecureString

Directory User Account password

Return Values

System.Management.Automation.PSCustomObject

New LDAP Group object with role assignment(s)

Examples

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

PS C:\> New-HPOVLdapGroup -d Domain1 -GroupName "MY Directory Group1" -roles @("Server administrator") -u 'Sarah Peterson'

Add "MY Directory Group1" from Domain1 with Server Administrator role and prompt for password for group validation.

 -------------------------- EXAMPLE 2 --------------------------

PS C:\> $roles = "Server administrator","Backup administrator"
PS C:\> $password = convertto-securestring -asplaintext "password123890" -force
PS C:\> New-HPOVLdapGroup -d Domain1 -GroupName "MY Directory Group1" -roles $roles -u 'Sarah Peterson' -p $password

Add "MY Directory Group1" from Domain1 with Server and Backup administrator roles, and specify password for group validation.

Related Links

• Show-HPOVLdapGroups
• Get-HPOVLdapGroup
• Remove-HPOVLdapGroup
• Set-HPOVLdapGroupRole
• Get-HPOVLdapDirectory
• New-HPOVLdapDirectory

---

Top

HPE OneView 2.00 Library

New-HPOVLdapGroup

Add a new Directory Group to appliance.

SYNTAX

New-HPOVLdapGroup [-authProvider] <String> [-GroupName] <String> [-Roles] <Array> [-UserName] <String> [-Password] <SecureString> [-ApplianceConnection] <Object> [<CommonParameters>]

Detailed Description

This Cmdlet provides the ability to add a new Directory Group to the appliance. You can use the Show-HPOVLdapGroups to retrieve a list of avialable Directory Groups from the specified Directory.

Parameters

-ApplianceConnection <Object>

Aliases [-Appliance]

Specify one or more HPOneView.Appliance.Connection object(s) or Name property value(s).

Default Value: ${Global:ConnectedSessions} | ? Default

Aliases	Appliance
Required?	true
Position?	named
Default value	(${Global:ConnectedSessions} | ? Default)
Accept pipeline input?	false
Accept wildcard characters?	False

-GroupName <String>

Aliases [-g, -group, -name] Directroy Group to add

Aliases	g, group, name
Required?	true
Position?	1
Default value
Accept pipeline input?	false
Accept wildcard characters?	False

-Password <SecureString>

Aliases [-p] Directory User account password

Aliases	p
Required?	true
Position?	4
Default value
Accept pipeline input?	true (ByValue)
Accept wildcard characters?	False

-Roles <Array>

Aliases [-r, -role] The role(s) to assign to the Directroy Group, in System.Array format. Accepted values are:

• Read only
• Infrastructure administrator
• Server administrator
• Storage administrator
• Network administrator
• Backup administrator

e.g. $roles = "Server administrator","Network administrator"

Aliases	r, role
Required?	true
Position?	2
Default value
Accept pipeline input?	false
Accept wildcard characters?	False

-UserName <String>

Aliases [-u] Directory Username to authenticate with

Aliases	u
Required?	true
Position?	3
Default value
Accept pipeline input?	false
Accept wildcard characters?	False

-authProvider <String>

Aliases [-d, -domain, -directory] LDAP/Active Directory Domain Name

Aliases	d, domain, directory
Required?	true
Position?	0
Default value
Accept pipeline input?	false
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)

Input Types

System.SecureString

Directory User Account password

Return Values

System.Management.Automation.PSCustomObject

New LDAP Group object with role assignment(s).

Examples

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

PS C:\> New-HPOVLdapGroup -d Domain1 -GroupName "MY Directory Group1" -roles @("Server administrator") -u 'Sarah Peterson'

Add "MY Directory Group1" from Domain1 with Server Administrator role and prompt for password for group validation.

 -------------------------- EXAMPLE 2 --------------------------

PS C:\> $roles = "Server administrator","Backup administrator"
PS C:\> $password = convertto-securestring -asplaintext "password123890" -force
PS C:\> New-HPOVLdapGroup -d Domain1 -GroupName "MY Directory Group1" -roles $roles -u 'Sarah Peterson' -p $password

Add "MY Directory Group1" from Domain1 with Server and Backup administrator roles, and specify password for group validation.

Related Links

• Show-HPOVLdapGroups
• Get-HPOVLdapGroup
• Remove-HPOVLdapGroup
• Set-HPOVLdapGroupRole
• Get-HPOVLdap
• New-HPOVLdap

---

Top

HPE OneView 1.20 Library

New-HPOVLdapGroup

Add a new Directory Group to appliance.

SYNTAX

New-HPOVLdapGroup [-authProvider] <authProvider> [-GroupName] <GroupName> [-Roles] <Roles> [-UserName] <UserName> [-Password] <Password> [<CommonParameters>]

Detailed Description

This cmdlet provides the ability to add a new Directory Group to the appliance. You can use the Show-HPOVLdapGroups to retrieve a list of avialable Directory Groups from the specified Directory.

Parameters

-authProvider <authProvider>

Aliases [-d, -domain, -directory] LDAP/Active Directory Domain Name

Aliases	None.
Required?	true
Position?	1
Default value
Accept pipeline input?	false
Accept wildcard characters?	false

-GroupName <GroupName>

Aliases [-g, -group, -name] Directroy Group to add

Aliases	None.
Required?	true
Position?	2
Default value
Accept pipeline input?	false
Accept wildcard characters?	false

-Roles <Roles>

Aliases [-r, -role] The role(s) to assign to the Directroy Group, in System.Array format. Accepted values are:

• Read only
• Infrastructure administrator
• Server administrator
• Storage administrator
• Network administrator
• Backup administrator

e.g. $roles = "Server administrator","Network administrator"

Aliases	None.
Required?	true
Position?	3
Default value
Accept pipeline input?	false
Accept wildcard characters?	false

-UserName <UserName>

Aliases [-u] Username to authenticate with

Aliases	None.
Required?	true
Position?	4
Default value
Accept pipeline input?	false
Accept wildcard characters?	false

-Password <Password>

Aliases [-p] User account password

Aliases	None.
Required?	true
Position?	5
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)

Input Types

System.SecureString Directory User Account password

Return Values

System.Management.Automation.PSCustomObject

New LDAP Group object with role assignment(s).

Examples

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

PS C:\> New-HPOVLdapGroup -d Domain1 -GroupName "MY Directory Group1" -roles @("Server administrator") -u 'Sarah Peterson'

Add "MY Directory Group1" from Domain1 with Server Administrator role and prompt for password for group validation.

 -------------------------- EXAMPLE 2 --------------------------

PS C:\> $roles = "Server administrator","Backup administrator"
PS C:\> $password = convertto-securestring -asplaintext "password123890" -force
PS C:\> New-HPOVLdapGroup -d Domain1 -GroupName "MY Directory Group1" -roles $roles -u 'Sarah Peterson' -p $password

Add "MY Directory Group1" from Domain1 with Server and Backup administrator roles, and specify password for group validation.

Related Links

• Show-HPOVLdapGroups
• Get-HPOVLdapGroup
• Remove-HPOVLdapGroup
• Set-HPOVLdapGroupRole
• Get-HPOVLdap
• New-HPOVLdap

---

Top