< Back
Remove-CertificateEnrollmentPolicyServer
Post
NAME Remove-CertificateEnrollmentPolicyServer
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] <Uri> -context {Machine | User} [-Confirm] [-WhatIf] [<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.
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.
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.
Required? true
Position? 1
Default value none
Accept pipeline input? True (ByValue, ByPropertyName)
Accept wildcard characters? false
-Confirm [<SwitchParameter>]
Prompts you for confirmation before running the cmdlet.Prompts you for confirmation before running the cmdlet.
Required? false
Position? named
Default value false
Accept pipeline input? false
Accept wildcard characters? false
-WhatIf [<SwitchParameter>]
Shows what would happen if the cmdlet runs. The cmdlet is not run.Shows what would happen if the cmdlet runs. The cmdlet is not run.
Required? false
Position? named
Default value false
Accept pipeline input? false
Accept wildcard characters? false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (https:/go.microsoft.com/fwlink/?LinkID=113216).
INPUTS
Microsoft.CertificateServices.Commands.EnrollmentPolicyServer
Contains information about the certificate enrollment policy.
OUTPUTS
None
EXAMPLE 1
PS C:\\>Remove-CertificateEnrollmentPolicyServer -Url https://www.contoso.com/policy/service.svc -Context User
This example removes the enrollment policy server configuration from the local user configuration with the given URL.
EXAMPLE 2
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
This example removes the enrollment policy server that is configured from the current user configuration.
RELATED LINKS
Online Version: http://go.microsoft.com/fwlink/p/?linkid=287537
Add-CertificateEnrollmentPolicyServer
Get-CertificateEnrollmentPolicyServer
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] <Uri> -context {Machine | User} [-Confirm] [-WhatIf] [<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.
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.
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.
Required? true
Position? 1
Default value none
Accept pipeline input? True (ByValue, ByPropertyName)
Accept wildcard characters? false
-Confirm [<SwitchParameter>]
Prompts you for confirmation before running the cmdlet.Prompts you for confirmation before running the cmdlet.
Required? false
Position? named
Default value false
Accept pipeline input? false
Accept wildcard characters? false
-WhatIf [<SwitchParameter>]
Shows what would happen if the cmdlet runs. The cmdlet is not run.Shows what would happen if the cmdlet runs. The cmdlet is not run.
Required? false
Position? named
Default value false
Accept pipeline input? false
Accept wildcard characters? false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (https:/go.microsoft.com/fwlink/?LinkID=113216).
INPUTS
Microsoft.CertificateServices.Commands.EnrollmentPolicyServer
Contains information about the certificate enrollment policy.
OUTPUTS
None
EXAMPLE 1
PS C:\\>Remove-CertificateEnrollmentPolicyServer -Url https://www.contoso.com/policy/service.svc -Context User
This example removes the enrollment policy server configuration from the local user configuration with the given URL.
EXAMPLE 2
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
This example removes the enrollment policy server that is configured from the current user configuration.
RELATED LINKS
Online Version: http://go.microsoft.com/fwlink/p/?linkid=287537
Add-CertificateEnrollmentPolicyServer
Get-CertificateEnrollmentPolicyServer