Cmdlets

Choose a cmdlet from the list on the left or search for a specific cmdlet. Choose a cmdlet from the list or search for a specific cmdlet.
About Help  Providers
 

Remove-CertificateEnrollmentPolicyServer

Remove-CertificateEnrollmentPolicyServer

microsoft.certificateservices.pkiclient.cmdlets.dll

Synopsis

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] [-context] [<CommonParameters>]

Detailed 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.

Parameters

-context <Context>

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

Aliases

None

Required?

true

Position

named

Default value

None

Accept pipeline input?

True (ByPropertyName)

Accept wildcard characters?

false

-Url <Uri>

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

Aliases

None

Required?

true

Position

1

Default value

None

Accept pipeline input?

True (ByValue, ByPropertyName)

Accept wildcard characters?

false

Input Type

Microsoft.CertificateServices.Commands.EnrollmentPolicyServer

Return Type

None

Notes

None

Examples

EXAMPLE 1

This example removes the enrollment policy server configuration from the local user configuration with the given URL.

PS C:\>Remove-CertificateEnrollmentPolicyServer -Url https://www.contoso.com/policy/service.svc -Context User

EXAMPLE 2

This example removes the enrollment policy server that is configured from the current user configuration.

PS C:\>$userPolicy = Get-CertificateEnrollmentPolicyServer -Scope All -Context User -Url https://www.contoso.com/policy/service.svc



PS C:\>Remove-CertificateEnrollmentPolicyServer -Url $userPolicy.url -Context User

Online Version
Add-CertificateEnrollmentPolicyServer
Get-CertificateEnrollmentPolicyServer