NAME
Submit-CertificateRequest
SYNOPSIS
Submits certificate request to a Certification Authority.
SYNTAX
Submit-CertificateRequest [-Path <FileInfo[]>] [<CommonParameters>]
Submit-CertificateRequest -CA <CertificateAuthority> [<CommonParameters>]
Submit-CertificateRequest [-Attribute <String[]>] [<CommonParameters>]
DESCRIPTION
Submits certificate request to a Certification Authority. The commands returns an object that indicates the status of the submission. If the certificate is issued immediately, issued certificate is included in the returned object.
PARAMETERS
-Path<FileInfo[]>
Specifies the path to a request file.
| Required? | true |
| Position? | 0 |
| Default value | |
| Accept pipeline input? | true (ByValue) |
| Accept wildcard characters? | false |
-CA<CertificateAuthority>
Specifies a Certification Authority object to which the request is submitted. CA object can be retrieved by running either Get-CertificationAuthority or Connect-CertificationAuthority commands.
| Required? | true |
| Position? | named |
| Default value | |
| Accept pipeline input? | false |
| Accept wildcard characters? | false |
-Attribute<String[]>
Specifies optional attributes which are passed along with the request and are used by Certification Authority to construct the certificate. The following syntax is used:
<AttributeName>:<AttributeValue>
where <AttributeName> is an attribute name and <AttributeValue> is the value of the attribute. This command accepts multiple attributes.
For example, Enterprise CAs require certificate template information in the request, however, not all applications adds this information to the request (for example, Internet Information Service console, Exchange Management Console, non-Microsoft tools and other). In this case you can pass certificate template as attribute:
CertificateTemplate:WebServer
where 'CertificateTemplate' is attribute name and 'WebServer' is attribute value (in a given example it is certificate template common name).
| Required? | false |
| 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 and OutVariable. For more information, type,
"get-help about_commonparameters".
INPUTS
IO.FileInfo[]
OUTPUTS
None.
NOTES
Author: Vadims Podans
Blog: http://en-us.sysadmins.lv
EXAMPLES
-------------- Example 1 --------------
PS C:\> $CA = Get-CA ca01.company.com
PS C:\> Submit-CertificateRequest -Path c:\request.req -CA $CA
In this example, a request contained in the 'c:\request.req' file is submitted to a CA server hosted on 'ca01.company.com' server.
-------------- Example 2 --------------
PS C:\> $CA = Get-CA ca01.company.com
PS C:\> Submit-CertificateRequest -Path c:\iis_ssl.req -CA $CA -Attribute "CertificateTemplate:WebServer"
In this example, a request contained in the 'c:\iis_ssl.req' file is submitted to a CA server hosted on 'ca01.company.com' server. The request is supposed to by issued based on a 'WebServer' certificate template.
RELATED LINKS