Edit

Share via

Install-AdcsWebEnrollment

  • Reference
Module:
ADCSDeployment

Installs the Certification Authority 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

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

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
Required:False
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
Required:False
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
Required:False
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
Required:False
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
Required:False
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 -?