Edit

Share via

Uninstall-AdcsEnrollmentWebService

Module:
ADCSDeployment Module

Uninstalls the Certificate Enrollment Web service or individual instances of it.

Syntax

UninstallSingleInstance (Default) 

Uninstall-AdcsEnrollmentWebService
    -CAConfig <String>
    -AuthenticationType <AuthenticationType>
    [-Force]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

UninstallAll 

Uninstall-AdcsEnrollmentWebService
    [-AllEnrollmentServices]
    [-Force]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

The Uninstall-AdcsEnrollmentWebService cmdlet uninstalls the Certificate Enrollment Web Service either entirely removing all instances of it or partially by removing individual instances.

Examples

Example 1: Uninstall all Enrollment Web Service role services

Uninstall-AdcsEnrollmentWebService -AllEnrollmentServices -Force

This command uninstalls all the Enrollment Web Service role services without prompting for confirmation.

Example 2: Uninstall an Enrollment Web Service role service using the specified CA

$params = @{
    CAConfig           = "APP1.corp.contoso.com\corp-APP1-CA"
    AuthenticationType = Certificate
}
Uninstall-AdcsEnrollmentWebService @params

This command uninstalls the Certificate Enrollment Web Service using the CA specified by the configuration named APP1.corp.contoso.com\corp-APP1-CA. The CA configuration is the CA Computer Name and CA common name separated by a backslash. The authentication type in use is Certificate.

Parameters

-AllEnrollmentServices

Indicates that this cmdlet removes all Certificate Enrollment Web Service instances.

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

UninstallAll
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments:False

-AuthenticationType

Specifies the authentication type of the of enrollment services instance to be uninstalled.

Parameter properties

Type:AuthenticationType
Default value:None
Accepted values:Kerberos, UserName, Certificate
Supports wildcards:False
DontShow:False

Parameter sets

UninstallSingleInstance
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments:False

-CAConfig

Specifies the configuration string of the certification authority (CA) for which this cmdlet uninstalls enrollment services. This parameter is used to identify which instance of the Certificate Enrollment Web Service is to be uninstalled when multiple are present.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

UninstallSingleInstance
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments:False

-Confirm

Prompts you for confirmation before running the cmdlet.

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False
Aliases:cf

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-Force

Forces the command to run without asking for user confirmation.

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet is not run.

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False
Aliases:wi

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

Inputs

String

Microsoft.CertificateServices.Deployment.Common.AuthenticationType

SwitchParameter

Outputs

Microsoft.CertificateServices.Deployment.Common.CES.EnrollmentServiceResult

Notes

  • The application directories are removed from their respective instance folders in the file system. The uninstall command does not remove the Secure Sockets Layer/Transport Layer Security (SSL/TLS) or the secure hypertext transfer protocol (https) bindings.