Edit

Get-CMApprovalRequest

  • Reference
Module:
ConfigurationManager

Gets an approval request to allow the installation of a Configuration Manager application.

Syntax

Get-CMApprovalRequest
   [-ApplicationName <String[]>]
   [-CurrentState <RequestState>]
   [-User <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]
Get-CMApprovalRequest
   [-CurrentState <RequestState>]
   -Id <String[]>
   [-User <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]
Get-CMApprovalRequest
   [-CurrentState <RequestState>]
   -InputObject <IResultObject>
   [-User <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]
Get-CMApprovalRequest
   [-CurrentState <RequestState>]
   -ModelName <String>
   [-User <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]
Get-CMApprovalRequest
   [-CurrentState <RequestState>]
   -RequestGuid <String>
   [-User <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]

Description

The Get-CMApprovalRequest cmdlet gets a request from a user to install a Configuration Manager application. You can specify an approval request by application name, application ID, or by user name.

Note

Run Configuration Manager cmdlets from the Configuration Manager site drive, for example PS XYZ:\>. For more information, see getting started.

Examples

Example 1: Get all approval requests

PS XYZ:\> Get-CMApprovalRequest

This command gets all pending Configuration Manager approval requests.

Example 2: Get an approval request by using an application ID

PS XYZ:\> Get-CMApprovalRequest -Id "1635223"

This command gets an approval request for an application with the specified ID.

Example 3: Get an approval request for a specific user

PS XYZ:\> Get-CMApprovalRequest -Application "HelloWorld" -User "tsqa\davidchew"

This command gets an approval request for the application HelloWorld for a specified user.

Parameters

-ApplicationName

Specifies an array of names of applications.

Type:String[]
Aliases:Application
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-CurrentState

Type:RequestState
Accepted values:Unknown, Requested, Canceled, Denied, Approved
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DisableWildcardHandling

This parameter treats wildcard characters as literal character values. You can't combine it with ForceWildcardHandling.

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

-ForceWildcardHandling

This parameter processes wildcard characters and may lead to unexpected behavior (not recommended). You can't combine it with DisableWildcardHandling.

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

-Id

Specifies an array of IDs of applications.

Type:String[]
Aliases:CIUniqueId
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

Specifies the input to this cmdlet. You can use this parameter, or you can pipe the input to this cmdlet.

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

-ModelName

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

-RequestGuid

Sepcifies the request ID.

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

-User

Specifies an array of user names of persons who submitted the approval request. Use the format domain\user.

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

Inputs

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Outputs

IResultObject[]

IResultObject