New HPOVApplianceCsr

Library Version 2.00

Library Version 1.20

HPE OneView 2.00 Library

New-HPOVApplianceCsr

Generate appliance CSR

SYNTAX

New-HPOVApplianceCsr [-Country] <String> [-State] <String> [-City] <String> [-Organization] <String> [-CommonName] <String> [-OrganizationalUnit] <String> [-AlternativeName] <String> [-ContactName] <String> [-Email] <String> [-Surname] <String> [-GivenName] <String> [-Initials] <String> [-DNQualifier] <String> [-ChallengePassword] <String> [-UnstructuredName] <String> [-ApplianceConnection] <Object> [<CommonParameters>]

Detailed Description

This Cmdlet will create the CSR for an given appliance, to then be submitted to a CA.

Parameters

-AlternativeName <String>

Aliases [-SAN] An optional entry containing additional names that apply to the owner of the certificate, possibly including additional e-mail addresses, DNS names, IP addresses and other identifiers.

Example: "hpov.example.com,hpov,192.168.1.1"

Aliases	SAN
Required?	true
Position?	6
Default value
Accept pipeline input?	false
Accept wildcard characters?	False

-ApplianceConnection <Object>

Aliases [-Appliance]

Specify one HPOneView.Appliance.Connection object or Name property value.

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

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

-ChallengePassword <String>

The challenge password is a required entry and must contain a minimum of 8 characters. If you wish to be prompted to supply the password, use an asterisk (*) character.

Aliases	None
Required?	true
Position?	13
Default value
Accept pipeline input?	false
Accept wildcard characters?	False

-City <String>

Aliases [-L, -Locality] The city or locality is a required entry, can contain up to 128 characters.

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

-CommonName <String>

Aliases [-CN] The common name is a required entry, and can be FQDN/hostname or IPv4/IPv6 address.

Example: "hpov.example.com"

Aliases	CN
Required?	true
Position?	4
Default value
Accept pipeline input?	false
Accept wildcard characters?	False

-ContactName <String>

Aliases [-Contact] The name of the contact person, may not exceed 64 characters.

Aliases	Contact
Required?	true
Position?	7
Default value
Accept pipeline input?	false
Accept wildcard characters?	False

-Country <String>

Aliases [-C] The country code is a required entry and must contain only two letters.

Aliases	C
Required?	true
Position?	0
Default value
Accept pipeline input?	false
Accept wildcard characters?	False

-DNQualifier <String>

The distinguished name qualifier, which further identifies the certificate recipient, which may not exceed 128 characters.

Aliases	None
Required?	true
Position?	12
Default value
Accept pipeline input?	false
Accept wildcard characters?	False

-Email <String>

The contact person's email address, which may not exceed 128 characters and is of the format name@domain.

Aliases	None
Required?	true
Position?	8
Default value
Accept pipeline input?	false
Accept wildcard characters?	False

-GivenName <String>

Aliases [-Giv] The contact person's first name, which may not exceed 64 characters.

Aliases	Giv
Required?	true
Position?	10
Default value
Accept pipeline input?	false
Accept wildcard characters?	False

-Initials <String>

The contact person's initials, which may not exceed 20 characters.

Aliases	None
Required?	true
Position?	11
Default value
Accept pipeline input?	false
Accept wildcard characters?	False

-Organization <String>

Aliases [-O] The organization name is a required entry, can contain up to 64 characters.

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

-OrganizationalUnit <String>

Aliases [-OU] The entry for the organizational unit name, may not exceed 64 characters.

Aliases	OU
Required?	true
Position?	5
Default value
Accept pipeline input?	false
Accept wildcard characters?	False

-State <String>

Aliases [-ST, -Province] The state or province is a required entry, can contain up to 128 characters.

Aliases	ST, Province
Required?	true
Position?	1
Default value
Accept pipeline input?	false
Accept wildcard characters?	False

-Surname <String>

Aliases [-Sur] The contact person's family name, which may not exceed 64 characters.

Aliases	Sur
Required?	true
Position?	9
Default value
Accept pipeline input?	false
Accept wildcard characters?	False

-UnstructuredName <String>

Aliases [-UN] Defined by the certificate authority, and may contain up to 64 characters. Consult the certificate authority's administrator or documentation for more information.

Aliases	UN
Required?	true
Position?	14
Default value
Accept pipeline input?	false
Accept wildcard characters?	False

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

None. You cannot pipe objects to this Cmdlet.

Return Values

System.Management.Automation.PSCustomObject Object that contains the base64data property, which can then be written to a file or submitted to CA.

Examples

 -------------------------- EXAMPLE 1 --------------------------
PS C:\> $CSR = @{
>> 	Country = "US";
>>  State = "California";
>>  City = "Palo Alto";
>>  Organization = "Hewlett-Packard";
>>  CommonName = "hpov.example.com";
>>  AlternativeName = "hpov.example.com,192.168.1.1,hpov"
>> }
>>
PS C:\> $request = New-HPOVApplianceCsr @CSR -ApplianceConnection Appliance.domain.com
PS C:\> Set-Content -path C:\dir\hpov.csr -value $request.base64Data -Force

Create a CSR request to submit to CA.

HPE OneView 1.20 Library