Get-RmsRequestInfo

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

Syntax

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

Description

The Get-RmsRequestInfo cmdlet generates a report about a specified 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 subpath <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 detailed report.

Examples

Example 1: Get a specified user request

PS C:\> Get-RmsRequestInfo -Path "." -RequestID 1000

This command displays information about a particular user request.

Example 2: Get a user request by type

PS C:\> Get-RmsUserRequestReport -Path "." -RequestType AcquireLicense -UserID 1 | Get-RmsRequestInfo -Path "."

This command displays detailed information about a user's request to acquire a license. The Get-RmsUserRequestReport cmdlet retrieves the user's license request and then pipes the results to the Get-RmsRequestInfo cmdlet to display the details of the request.

Parameters

-Confirm

Prompts you for confirmation before running the cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required: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[]
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-RequestId

Specifies the unique internal ID of a user request.

Type:Int64
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False