Get-CMApprovalRequest
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-CMApprovalRequestThis 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