< Back
Uninstall-CCertificate
Post
NAME Uninstall-CCertificate
SYNOPSIS
Removes a certificate from a store for the user or machine account.
SYNTAX
Uninstall-CCertificate -Thumbprint <String> [-WhatIf] [-Confirm] [<CommonParameters>]
Uninstall-CCertificate -Thumbprint <String> -StoreLocation {CurrentUser | LocalMachine} -CustomStoreName <String>
[-Session <PSSession[]>] [-WhatIf] [-Confirm] [<CommonParameters>]
Uninstall-CCertificate -Thumbprint <String> -StoreLocation {CurrentUser | LocalMachine} -StoreName {AddressBook |
AuthRoot | CertificateAuthority | Disallowed | My | Root | TrustedPeople | TrustedPublisher} [-Session
<PSSession[]>] [-WhatIf] [-Confirm] [<CommonParameters>]
Uninstall-CCertificate -Certificate <X509Certificate2> -StoreLocation {CurrentUser | LocalMachine}
-CustomStoreName <String> [-Session <PSSession[]>] [-WhatIf] [-Confirm] [<CommonParameters>]
Uninstall-CCertificate -Certificate <X509Certificate2> -StoreLocation {CurrentUser | LocalMachine} -StoreName
{AddressBook | AuthRoot | CertificateAuthority | Disallowed | My | Root | TrustedPeople | TrustedPublisher}
[-Session <PSSession[]>] [-WhatIf] [-Confirm] [<CommonParameters>]
DESCRIPTION
The `Uninstall-CCertificate` function uses .NET's certificates API to remove a certificate from a given store for
the machine or current user. Use the thumbprint to identify which certificate to remove. The thumbprint is unique
to each certificate. The user performing the removal must have read and write permission on the store where the
certificate is located.
If the certificate isn't in the store, nothing happens, not even an error.
To uninstall a certificate from a remote computer, use the `Session`parameter, which was added in Carbon 2.1.0.
You can create a new session with the `New-PSSession` cmdlet.
You can uninstall a certificate using just its thumbprint (this functionality is new in Carbon 2.5.0).
`Uninstall-CCertificate` will search through all certificate locations and stores and uninstall all certificates
that have the thumbprint. When you enumerate all certificates over a remoting session, you get a terminating `The
system cannot open the device or file specified` error, so you can't delete a certificate with just a thumbprint
over remoting.
PARAMETERS
-Thumbprint <String>
The thumbprint of the certificate to remove.
If you want to uninstall the certificate from all stores it is installed in, you can pipe the thumbprint to
this parameter or you can pipe a certificate object. (This functionality was added in Carbon 2.5.0.)
Required? true
Position? named
Default value
Accept pipeline input? true (ByValue, ByPropertyName)
Accept wildcard characters? false
-Certificate <X509Certificate2>
The certificate to remove
Required? true
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-StoreLocation
The location of the certificate's store.
Required? true
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-StoreName
The name of the certificate's store.
Required? true
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-CustomStoreName <String>
The name of the non-standard, custom store where the certificate should be un-installed.
Required? true
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-Session <PSSession[]>
Use the `Session` parameter to uninstall a certificate on remote computer(s) using PowerShell remoting. Use
`New-PSSession` to create a session.
Due to a bug in PowerShell, you can't remove a certificate by just its thumbprint over remoting. Using just a
thumbprint requires us to enumerate through all installed certificates. When you do this over remoting,
PowerShell throws a terminating `The system cannot open the device or file specified` error.
This parameter was added in Carbon 2.1.0.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-WhatIf [<SwitchParameter>]
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-Confirm [<SwitchParameter>]
Required? false
Position? named
Default value
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
OUTPUTS
-------------------------- EXAMPLE 1 --------------------------
PS C:\\>Uninstall-CCertificate -Thumbprint 570895470234023dsaaefdbcgbefa
Demonstrates how to delete a certificate from all stores it is installed in. `Uninstall-CCertificate` searches
every certificate stores and deletes all certificates with the given thumbprint. This functionality was added in
Carbon 2.5.0.
-------------------------- EXAMPLE 2 --------------------------
PS C:\\>'570895470234023dsaaefdbcgbefa' | Uninstall-CCertificate
Demonstrates that you can pipe a thumbprint to `Uninstall-CCertificate`. The certificate is uninstall from all
stores it is in. This functionality was added in Carbon 2.5.0.
-------------------------- EXAMPLE 3 --------------------------
PS C:\\>Get-Item -Path 'cert:\\LocalMachine\\My\\570895470234023dsaaefdbcgbefa' | Uninstall-CCertificate
Demonstrates that you can pipe a certificate `Uninstall-CCertificate`. The certificate is uninstalled from all
stores it is in. This functionality was added in Carbon 2.5.0.
-------------------------- EXAMPLE 4 --------------------------
>Uninstall-CCertificate -Thumbprint 570895470234023dsaaefdbcgbefa -StoreLocation CurrentUser -StoreName My
Removes the 570895470234023dsaaefdbcgbefa certificate from the current user's Personal certificate store.
-------------------------- EXAMPLE 5 --------------------------
>$cert = Get-CCertificate -FriendlyName 'Carbon Testing Certificate' -StoreLocation LocalMachine -StoreName Root
> Uninstall-CCertificate -Certificate $cert -StoreLocation LocalMachine -StoreName Root
Removes the certificate with friendly name 'Carbon Testing Certificate' from the local machine's Trusted Root
Certification Authorities store.
-------------------------- EXAMPLE 6 --------------------------
PS C:\\>Uninstall-CCertificate -Thumbprint 570895470234023dsaaefdbcgbefa -StoreLocation LocalMachine -StoreName
'SharePoint'
Demonstrates how to uninstall a certificate from a custom, non-standard store.
-------------------------- EXAMPLE 7 --------------------------
>Uninstall-CCertificate -Thumbprint 570895470234023dsaaefdbcgbefa -StoreLocation CurrentUser -StoreName My
-Session (New-PSSession -ComputerName remote1,remote2)
Demonstrates how to uninstall a certificate from a remote computer.
RELATED LINKS
SYNOPSIS
Removes a certificate from a store for the user or machine account.
SYNTAX
Uninstall-CCertificate -Thumbprint <String> [-WhatIf] [-Confirm] [<CommonParameters>]
Uninstall-CCertificate -Thumbprint <String> -StoreLocation {CurrentUser | LocalMachine} -CustomStoreName <String>
[-Session <PSSession[]>] [-WhatIf] [-Confirm] [<CommonParameters>]
Uninstall-CCertificate -Thumbprint <String> -StoreLocation {CurrentUser | LocalMachine} -StoreName {AddressBook |
AuthRoot | CertificateAuthority | Disallowed | My | Root | TrustedPeople | TrustedPublisher} [-Session
<PSSession[]>] [-WhatIf] [-Confirm] [<CommonParameters>]
Uninstall-CCertificate -Certificate <X509Certificate2> -StoreLocation {CurrentUser | LocalMachine}
-CustomStoreName <String> [-Session <PSSession[]>] [-WhatIf] [-Confirm] [<CommonParameters>]
Uninstall-CCertificate -Certificate <X509Certificate2> -StoreLocation {CurrentUser | LocalMachine} -StoreName
{AddressBook | AuthRoot | CertificateAuthority | Disallowed | My | Root | TrustedPeople | TrustedPublisher}
[-Session <PSSession[]>] [-WhatIf] [-Confirm] [<CommonParameters>]
DESCRIPTION
The `Uninstall-CCertificate` function uses .NET's certificates API to remove a certificate from a given store for
the machine or current user. Use the thumbprint to identify which certificate to remove. The thumbprint is unique
to each certificate. The user performing the removal must have read and write permission on the store where the
certificate is located.
If the certificate isn't in the store, nothing happens, not even an error.
To uninstall a certificate from a remote computer, use the `Session`parameter, which was added in Carbon 2.1.0.
You can create a new session with the `New-PSSession` cmdlet.
You can uninstall a certificate using just its thumbprint (this functionality is new in Carbon 2.5.0).
`Uninstall-CCertificate` will search through all certificate locations and stores and uninstall all certificates
that have the thumbprint. When you enumerate all certificates over a remoting session, you get a terminating `The
system cannot open the device or file specified` error, so you can't delete a certificate with just a thumbprint
over remoting.
PARAMETERS
-Thumbprint <String>
The thumbprint of the certificate to remove.
If you want to uninstall the certificate from all stores it is installed in, you can pipe the thumbprint to
this parameter or you can pipe a certificate object. (This functionality was added in Carbon 2.5.0.)
Required? true
Position? named
Default value
Accept pipeline input? true (ByValue, ByPropertyName)
Accept wildcard characters? false
-Certificate <X509Certificate2>
The certificate to remove
Required? true
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-StoreLocation
The location of the certificate's store.
Required? true
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-StoreName
The name of the certificate's store.
Required? true
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-CustomStoreName <String>
The name of the non-standard, custom store where the certificate should be un-installed.
Required? true
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-Session <PSSession[]>
Use the `Session` parameter to uninstall a certificate on remote computer(s) using PowerShell remoting. Use
`New-PSSession` to create a session.
Due to a bug in PowerShell, you can't remove a certificate by just its thumbprint over remoting. Using just a
thumbprint requires us to enumerate through all installed certificates. When you do this over remoting,
PowerShell throws a terminating `The system cannot open the device or file specified` error.
This parameter was added in Carbon 2.1.0.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-WhatIf [<SwitchParameter>]
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-Confirm [<SwitchParameter>]
Required? false
Position? named
Default value
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
OUTPUTS
-------------------------- EXAMPLE 1 --------------------------
PS C:\\>Uninstall-CCertificate -Thumbprint 570895470234023dsaaefdbcgbefa
Demonstrates how to delete a certificate from all stores it is installed in. `Uninstall-CCertificate` searches
every certificate stores and deletes all certificates with the given thumbprint. This functionality was added in
Carbon 2.5.0.
-------------------------- EXAMPLE 2 --------------------------
PS C:\\>'570895470234023dsaaefdbcgbefa' | Uninstall-CCertificate
Demonstrates that you can pipe a thumbprint to `Uninstall-CCertificate`. The certificate is uninstall from all
stores it is in. This functionality was added in Carbon 2.5.0.
-------------------------- EXAMPLE 3 --------------------------
PS C:\\>Get-Item -Path 'cert:\\LocalMachine\\My\\570895470234023dsaaefdbcgbefa' | Uninstall-CCertificate
Demonstrates that you can pipe a certificate `Uninstall-CCertificate`. The certificate is uninstalled from all
stores it is in. This functionality was added in Carbon 2.5.0.
-------------------------- EXAMPLE 4 --------------------------
>Uninstall-CCertificate -Thumbprint 570895470234023dsaaefdbcgbefa -StoreLocation CurrentUser -StoreName My
Removes the 570895470234023dsaaefdbcgbefa certificate from the current user's Personal certificate store.
-------------------------- EXAMPLE 5 --------------------------
>$cert = Get-CCertificate -FriendlyName 'Carbon Testing Certificate' -StoreLocation LocalMachine -StoreName Root
> Uninstall-CCertificate -Certificate $cert -StoreLocation LocalMachine -StoreName Root
Removes the certificate with friendly name 'Carbon Testing Certificate' from the local machine's Trusted Root
Certification Authorities store.
-------------------------- EXAMPLE 6 --------------------------
PS C:\\>Uninstall-CCertificate -Thumbprint 570895470234023dsaaefdbcgbefa -StoreLocation LocalMachine -StoreName
'SharePoint'
Demonstrates how to uninstall a certificate from a custom, non-standard store.
-------------------------- EXAMPLE 7 --------------------------
>Uninstall-CCertificate -Thumbprint 570895470234023dsaaefdbcgbefa -StoreLocation CurrentUser -StoreName My
-Session (New-PSSession -ComputerName remote1,remote2)
Demonstrates how to uninstall a certificate from a remote computer.
RELATED LINKS