Remove-CertificateEnrollmentPolicyServer
Removes an enrollment policy server and the URL of the enrollment policy server from the current user or local computer configuration.
Syntax
Default (Default)
Remove-CertificateEnrollmentPolicyServer
[-Url] <Uri>
-context <Context>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
The Remove-CertificateEnrollmentPolicyServer cmdlet removes an enrollment policy server from the
current user or local computer configuration. This cmdlet also removes any policy cache file and
credentials from the vault.
Only one enrollment policy server configuration is removed from the user configured location at a time.
If a scope of All is specified and the same URL exists in the local computer (machine) and User
contexts, then this cmdlet will fail.
An error is generated if the specified URL does not exist in the given scope.
Any policy cache file and credentials are also removed from the vault.
Examples
EXAMPLE 1
$params = @{
Url = 'https://www.contoso.com/policy/service.svc'
Context = 'User'
}
Remove-CertificateEnrollmentPolicyServer @params
This example removes the enrollment policy server configuration from the local user configuration with the given URL.
EXAMPLE 2
$params = @{
Scope = 'All'
Context = 'User'
Url = 'https://www.contoso.com/policy/service.svc'
}
$userPolicy = Get-CertificateEnrollmentPolicyServer @params
Remove-CertificateEnrollmentPolicyServer -Url $userPolicy.Url -Context User
This example removes the enrollment policy server that is configured from the current user configuration.
Parameters
-Confirm
Prompts you for confirmation before running the cmdlet.
Parameter properties
| Type: | SwitchParameter |
| Default value: | False |
| 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 |
-Context
Specifies that information about the location of an enrollment policy server should be removed from
either the User or computer (Machine) context.
Parameter properties
| Type: | Context |
| Default value: | None |
| Accepted values: | Machine, User |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | True |
| Value from pipeline: | False |
| Value from pipeline by property name: | True |
| Value from remaining arguments: | False |
-Url
Specifies the URL of the enrollment policy server to remove from the local configuration.
Parameter properties
| Type: | Uri |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | 0 |
| Mandatory: | True |
| Value from pipeline: | True |
| Value from pipeline by property name: | True |
| 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: | False |
| 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
Microsoft.CertificateServices.Commands.EnrollmentPolicyServer
Contains information about the certificate enrollment policy.