Remove-QADLocalCertificateStore

From PowerGUI Wiki

Jump to: navigation, search

Delete X.509 certificate stores held in a store location such as CurrentUser or LocalMachine.

This cmdlet is part of the Quest ActiveRoles Server product. Use Get-QARSProductInfo to view information about ActiveRoles Server.

Contents

Syntax

Remove-QADLocalCertificateStore [-StoreName] <string[]> [[-StoreLocation] {CurrentUser | LocalMachine}] [-Confirm] [-WhatIf] [<CommonParameters>]

Remove-QADLocalCertificateStore [-Store] <X509CertificateStoreUI> [-Confirm] [-WhatIf] [<CommonParameters>]

Detailed Description

Use this cmdlet to delete a certificate store. You can identify the certificate store either by name and location or by using an output object of the Get-QADLocalCertificateStore cmdlet (see examples).

The cmdlet allows you to specify a store location from which to remove certificate stores. Certificate stores are physical stores in which certificates are saved and managed. Store locations are high-level containers that group the certificate stores for the current user and for all users. Each system has the CurrentUser store location and the LocalMachine (all users) store location.



Parameters

Name Description Required? Pipeline Input Default Value
Store Use this parameter to supply an object representing the certificate store to remove. This could be an object output by the Get-QADLocalCertificateStore cmdlet (see examples). true true (ByValue)
StoreLocation Specify the location from which to remove a certificate store. The possible parameter values are:
  CurrentUser   The store holds certificates for the current user - default value.
  LocalMachine  The store holds certificates for the local machine (all users).

The following values are permitted for this object type.

false false CurrentUser
StoreName Specify the name of the certificate store to remove. Use a string array of names to remove more than one store at a time. true true (ByValue, ByPropertyName)
Confirm Prompts you for confirmation before executing the command. false false
WhatIf Describes what would happen if you executed the command without actually executing the command. false false

Examples

EXAMPLE 1

Get-QADLocalCertificateStore MyStore* |	
 Remove-QADLocalCertificateStore

Description


Remove all certificate stores whose name begins with MyStore, from the CurrentUser store location.

In this command, the target certificate stores are retrieved by Get-QADLocalCertificateStore. Since the StoreLocation parameter is not supplied, the cmdlet retrieves certificate stores from the CurrentUser store location. The output objects are passed to Remove-QADLocalCertificateStore through the Store parameter, which is designed to accept parameter values from the pipeline.

EXAMPLE 2

Remove-QADLocalCertificateStore MyStore*

Description


Remove all certificate stores whose name begins with MyStore, from the CurrentUser store location.

In this command, the target certificate stores are identified by name and location through the StoreName and StoreLocation parameters. Since the StoreLocation parameter is not supplied, the cmdlet looks for certificate stores in the CurrentUser store location.

Personal tools