Table of contents
TLS
TOC
Collapse the table of content
Expand the table of content

Get-RmsCertChain

Brian Lich|Last Updated: 3/26/2017

SYNOPSIS

Generates a report about the certificate chain of a particular user request for the AD RMS cluster.

SYNTAX

Get-RmsCertChain -RequestId <Int64> [-Path] <String[]> [-WhatIf] [-Confirm] [<CommonParameters>]

DESCRIPTION

The Get-RmsCertChain cmdlet generates a report about the certificate chain of a particular user request on the Active Directory Rights Management Services (AD RMS) cluster.

To obtain the report, specify the RequestID of the user request for which you want a report and then set the Path parameter to the AD RMS provider drive path <PSDrive>:\Report where <PSDrive> is the provider drive ID. You can also specify a relative path. For example, a dot (.) specifies the current location.

Use the Get-RmsUserRequestReport cmdlet to obtain the RequestID of the user request for which you want a certificate chain report.

EXAMPLES

Example 1: Get a certificate chain by ID

PS C:\> Get-RmsCertChain -Path "." -RequestId 100

This command displays the certification chain of the request with the ID of 100.

Example 2: Pass in a user request ID to get its certificate chain

PS C:\> Get-RmsUserRequestReport -Path "." -RequestType GetClientLicensorCertificate -UserId 1 | Get-RmsCertChain -Path "."

This command uses the Get-RmsUserRequestReport cmdlet to retrieve the ID of a user request and then pipes the ID to the Get-RmsCertChain cmdlet to display the certificate chain of the request.

PARAMETERS

-Confirm

Prompts you for confirmation before running the cmdlet.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf

Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False

-Path

Specifies a provider drive and path or relative path on the current drive. Use a dot (.) to specify the current location. This parameter does not accept wildcards and has no default value.

Type: String[]
Parameter Sets: (All)
Aliases: 

Required: True
Position: 0
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-RequestId

Specifies the unique internal ID of a user request.

Type: Int64
Parameter Sets: (All)
Aliases: 

Required: True
Position: Named
Default value: None
Accept pipeline input: True (ByPropertyName, ByValue)
Accept wildcard characters: False

-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet is not run.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi

Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

INPUTS

OUTPUTS

NOTES

Using Windows PowerShell with AD RMS

Get-RmsCertInfo

Get-RmsChildCert

Get-RmsUserRequestReport

© 2017 Microsoft