Export-QADCertificateRevocationList

From PowerGUI Wiki

Jump to: navigation, search

Export a certificate revocation list (CRL) to a byte array or a file.

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

Contents

Syntax

Export-QADCertificateRevocationList [-CRL] <CertificateRevocationListUI[]> [-Encoding <CertificateEncoding>] [-File <string>] [<CommonParameters>]

Detailed Description

Use this cmdlet to export the certificate revocation list (CRL) represented by a given CRL object, to a byte array or a file. The cmdlet can take an output object of the Get-QADCertificateRevocationList cmdlet, and return a byte array containing the CRL data found in that object. Another option is to have the cmdlet export the certificate revocation list directly to a file specified (see examples).



Parameters

Name Description Required? Pipeline Input Default Value
CRL Use this parameter to specify the CRL objects representing the certificate revocation lists to export. This could be output objects of the Get-QADCertificateRevocationList cmdlet (see examples). true true (ByValue)
Encoding Use this parameter to specify how to encode the export data. The possible parameter values are:
   Binary    The export data is a pure binary sequence
   Base64    The export data is base64-encoded (default value)
false false
File Use this parameter to specify the path and name of a file to which you want to export the certificate revocation lists. The path can be an absolute path, such as c:\export.crl, or a relative path. If the path or file name includes spaces, enclose the parameter value in quotation marks. false false

Examples

EXAMPLE 1

Get-QADLocalCertificateStore CertificateAuthority |	
 Get-QADCertificateRevocationList |	
 %{$count++; Export-QADCertificateRevocationList $_ -File "C:\crl\local-$($count).crl"} |	
 Out-Null

Description


In this command, the Get-QADLocalCertificateStore CertificateAuthority | Get-QADCertificateRevocationList pipeline retrieves the certificate revocation lists from the Intermediate Certification Authorities certificate store in the CurrentUser store location and passes the CRL objects to a script block where Export-QADCertificateRevocationList exports each CRL to a separate file. The export files are base64-encoded since the Encoding parameter is omitted.

EXAMPLE 2

Get-QADPKIObject CDP |	
 Get-QADCertificateRevocationList |	
 %{$count++; Export-QADCertificateRevocationList $_ -File "C:\crl\ad-$($count).crl" -Encoding Binary} |	
 Out-Null

Description


In this command, the Get-QADPKIObject CDP | Get-QADCertificateRevocationList pipeline retrieves the certificate revocation lists from the CRL distribution point (CDP) container in Active Directory and passes the CRL objects to a script block where Export-QADCertificateRevocationList exports each CRL to a separate file. The export files are binary-encoded, which is due to the Encoding parameter value of Binary.

Personal tools