Quantcast
Channel: Public Key Infrastructure PowerShell module
Viewing all articles
Browse latest Browse all 729

Updated Wiki: Submit-CertificateRequest

$
0
0

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

Get-CertificationAuthority
Connect-CertificationAuthority


Viewing all articles
Browse latest Browse all 729

Trending Articles



<script src="https://jsc.adskeeper.com/r/s/rssing.com.1596347.js" async> </script>