Submits certificate request to a Certification Authority.
Submit-CertificateRequest [-Path] <FileInfo[]> -CertificationAuthority <CertificateAuthority> [-Credential <PSCredential>] [-Attribute <String[]>] [<CommonParameters>] Submit-CertificateRequest [-Path] <FileInfo[]> -EnrollmentPolicyServer <PolicyServerClient> [-Credential <PSCredential>] [-Attribute <String[]>] [<CommonParameters>]
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.
Specifies the path to a request file.
Required? | True |
Position? | 0 |
Default value | |
Accept pipeline input? | true (ByValue) |
Accept wildcard characters? | False |
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 |
Provides credentials to access enrollment policy server in the case when existing credentials are not saved in the credential vault. If enrollment policy server uses user name and password authentication, UserName field contains user name account name and Password field contains the password for the user account. If enrollment policy server uses certificate-based authentication, UserName field contains client authentication certificate's thumbprint and Password field must be empty (not set).
Required? | False |
Position? | named |
Default value | |
Accept pipeline input? | false |
Accept wildcard characters? | False |
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 an 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 |
Specifies the enrollment policy server endpoint to which the request will be sent. Enrollment policy server endpoint object can be retrieved by running Get-EnrollmentPolicyServerClient command.
Required? | True |
Position? | named |
Default value | |
Accept pipeline input? | false |
Accept wildcard characters? | False |
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, InformationAction, InformationVariable,
WarningAction, WarningVariable, OutBuffer, PipelineVariable and OutVariable.
For more information, see about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).
PKI.Enrollment.CertRequestStatus
Author: Vadims Podans
Blog: https://www.sysadmins.lv