New HPOVApplianceCsr - HewlettPackard/POSH-HPEOneView GitHub Wiki

Generate appliance CSR

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

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

-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"

-ApplianceConnection <Object>

Aliases [-Appliance]

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

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

-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.

-City <String>

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

-CnsaCompliantRequest <bool>

Specify to create a CNSA compliant certificate request. By default the certificate request will create a 2048bit key length, while CNSA compliant will create a 3072bit key length.

-CommonName <String>

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

Example: "hpov.example.com"

-ContactName <String>

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

-Country <String>

Aliases [-C] The country code in either Full English or ISO3166-2 two-character format, is a required entry and must contain only two letters.

-DNQualifier <String>

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

-Email <String>

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

-GivenName <String>

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

-Initials <String>

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

-Organization <String>

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

-OrganizationalUnit <String>

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

-State <String>

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

-Surname <String>

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

-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.

<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)

None. You cannot pipe objects to this cmdlet.

System.Management.Automation.PSCustomObject

Object that contains the base64data property, which can then be written to a file or submitted to CA

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

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

Create a CSR request to submit to CA.

Generate appliance CSR

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

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

-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"

-ApplianceConnection <Object>

Aliases [-Appliance]

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

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

-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.

-City <String>

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

-CommonName <String>

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

Example: "hpov.example.com"

-ContactName <String>

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

-Country <String>

Aliases [-C] The country code in either Full English or ISO3166-2 two-character format, is a required entry and must contain only two letters.

-DNQualifier <String>

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

-Email <String>

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

-GivenName <String>

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

-Initials <String>

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

-Organization <String>

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

-OrganizationalUnit <String>

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

-State <String>

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

-Surname <String>

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

-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.

<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)

None. You cannot pipe objects to this cmdlet.

System.Management.Automation.PSCustomObject

Object that contains the base64data property, which can then be written to a file or submitted to CA

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

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

Create a CSR request to submit to CA.