Remove-CACrlDistributionPoint
Remove-CACrlDistributionPoint
Removes the URI for the certificate revocation list (CRL) distribution point (CDP) from the certification authority (CA).
Syntax
Parameter Set: Default
Remove-CACrlDistributionPoint [-Uri] <String> [-AddToCertificateCdp] [-AddToCrlCdp] [-AddToCrlIdp] [-AddToFreshestCrl] [-Force] [-PublishDeltaToServer] [-PublishToServer] [ <CommonParameters>]
Detailed Description
The Remove-CACRLDistributionPoint cmdlet removes the uniform resource identifier (URI) for the certificate revocation list (CRL) distribution point from the certification authority (CA).
Parameters
-AddToCertificateCdp
Remove from the CDP extension of issued certificates.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
true (ByPropertyName) |
Accept Wildcard Characters? |
false |
-AddToCrlCdp
Remove from the certificate revocation list (CRL).
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
true (ByPropertyName) |
Accept Wildcard Characters? |
false |
-AddToCrlIdp
Remove from the IDP extension of issued certificates.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
true (ByPropertyName) |
Accept Wildcard Characters? |
false |
-AddToFreshestCrl
Remove from the most recent (freshest) certificate revocation list (CRL).
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
true (ByPropertyName) |
Accept Wildcard Characters? |
false |
-Force
Forces the command to run without asking for user confirmation.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-PublishDeltaToServer
Remove the delta certificate revocation list (CRL).
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
true (ByPropertyName) |
Accept Wildcard Characters? |
false |
-PublishToServer
Remove from the base certificate revocation list (CRL).
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
true (ByPropertyName) |
Accept Wildcard Characters? |
false |
-Uri<String>
Specifies the uniform resource identifier (URI) for the distribution point location of the certificate revocation list (CRL). This is the location from where status information about certificate revocation has been retrieved and/or the location the CRL was published.
Aliases |
none |
Required? |
true |
Position? |
2 |
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.
- System.String
Outputs
The output type is the type of the objects that the cmdlet emits.
Microsoft.CertificateServices.Administration.Commands.CA.CrlDistributionPointResult
There is an output property named RestartCA, which when set to True indicates that the CA service (certsvc) needs to be restarted.
Examples
-------------------------- EXAMPLE 1 --------------------------
Description
-----------
Removes all URIs for all distribition points that contain the specified URI value ("http://corp.contoso.com/rootca.crl").
C:\PS>Remove-CACrlDistributionPoint -URI "http://corp.contoso.com/rootca.crl"
-------------------------- EXAMPLE 2 --------------------------
Description
-----------
Removes only the URIs that are set to a value of "http://corp.contoso.com/rootca.crl" and for which the AddToCertificateCdp is set.
C:\PS>Remove-CACrlDistributionPoint -Uri "http://corp.contoso.com/rootca.crl" -AddToCertificateCdp
-------------------------- EXAMPLE 3 --------------------------
Description
-----------
Removes only the uniform resource indicators (URIs) that are unique to the URI specified ("https://www.contoso.com/pki/orca.crl") and the combination of flags that are set or included (AddToCertificateCdp, AddToCrlIdp).
C:\PS>Remove-CACrlDistributionPoint -Uri "https://www.contoso.com/pki/orca.crl" -AddToCertificateCdp -AddToCrlIdp