Remove-CertificateEnrollmentPolicyServer

Removes an enrollment policy server and the URL of the enrollment policy server from the current user or local computer configuration.

Syntax

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.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Context

Specifies that information about the location of an enrollment policy server should be removed from either the User or computer (Machine) context.

Type:Context
Accepted values:Machine, User
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Url

Specifies the URL of the enrollment policy server to remove from the local configuration.

Type:Uri
Position:0
Default value:None
Required:True
Accept pipeline input:True
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:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Inputs

Microsoft.CertificateServices.Commands.EnrollmentPolicyServer

Contains information about the certificate enrollment policy.

Outputs

None