Remove-CertificateEnrollmentPolicyServer
Remove-CertificateEnrollmentPolicyServer
Removes an enrollment policy server and the URL of the enrollment policy server from the current user or local computer configuration.
Syntax
Parameter Set: Default
Remove-CertificateEnrollmentPolicyServer [-Url] <Uri> -context <Context> {Machine | User} [ <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 |
<CommonParameters>
This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).
Inputs
The input type is the type of the objects that you can pipe to the cmdlet.
Microsoft.CertificateServices.Commands.EnrollmentPolicyServer
Contains information about the certificate enrollment policy.
Outputs
The output type is the type of the objects that the cmdlet emits.
- 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