Install-Adcs
Web
Enrollment
Installs the Certification Authority Web Enrollment.
Syntax
Install-Adcs Web Enrollment
[-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.
Parameters
-CAConfig
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 |
Accept wildcard characters: | False |
-Confirm
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 |
-Credential
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 |
Accept wildcard characters: | False |
-Force
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 |
-WhatIf
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
String
PSCredential
Outputs
Microsoft.CertificateServices.Deployment.Common.WEP.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 -?