Install-Adcs
Web
Enrollment
Syntax
Install-AdcsWebEnrollment
[-CAConfig <String>]
[-Force]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
The Install-AdcsWebEnrollment cmdlet performs initial installation and configuration of the Certification Authority (CA) Web Enrollment role service. To remove the Web Enrollment role service use the Uninstall-AdcsWebEnrollment cmdlet.
You can import the cmdlet by running the following commands from Windows PowerShell:
-
Import-Module ServerManager
-
Add-WindowsFeature Adcs-Web-Enrollment
Examples
Example 1: Install the Web Enrollment role service to a CA with confirmation
PS C:\> Install-AdcsWebEnrollment -CAConfig "<CAComputerName>\<CACommonName>"
This command installs the Web Enrollment role service to a CA specified by
<CAComputerName>\<CACommonName>
.
Replace the computer name of the CA for
<CAComputerName>
and replace the CA common name for
<CACommonName>
when running the command.
Example 1: Install the Web Enrollment role service to a CA without confirmation
PS C:\> Install-AdcsWebEnrollment -CAConfig "<CAComputerName>\<CACommonName>" -Force
This command installs the Web Enrollment role service to a CA specified by
<CAComputerName>\<CACommonName>
without requiring user confirmation.
Replace the computer name of the CA for
<CAComputerName>
and replace the CA common name for
<CACommonName>
when running the command.
Optional Parameters
Specifies the CA config parameter string. Do not specify this if there is a local CA installed.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | True (ByPropertyName) |
Accept wildcard characters: | False |
Prompts you for confirmation before running the cmdlet.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Specifies a
PSCredential
object for the CA Web Enrollment.
To obtain a credential object, use the
Get-Credential
cmdlet.
For more information, type
Get-Help Get-Credential
.
If the Web Enrollment service is configured to use Standalone CA, then an account that is a member of the local Administrators on the CA is required.
If the Web Enrollment service is configured to use an Enterprise CA, then an account that is a member of Domain Admins is required.
Type: | PSCredential |
Position: | Named |
Default value: | None |
Accept pipeline input: | True (ByPropertyName) |
Accept wildcard characters: | False |
Forces the command to run without asking for user confirmation.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Shows what would happen if the cmdlet runs. The cmdlet is not run.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Inputs
PSCredential
Outputs
Microsoft.CertificateServices.Deployment.Commands.WebEnrollment.WebEnrollmentResult
Notes
-
Ensure you run Windows PowerShell as an administrator. You can use the
Force
parameter to bypass the prompt for confirmation.
To see parameters, run the following command:
Install-AdcsWebEnrollment -?