Set-CMApprovalRequest

Applies To: System Center 2012 Configuration Manager SP1

[This topic is pre-release documentation and is subject to change in future releases. Blank topics are included as placeholders.]

Set-CMApprovalRequest

Changes an approval request for a Configuration Manager application.

Syntax

Parameter Set: SetSecurityScopeById
Set-CMApprovalRequest -Id <String[]> -SecurityScopeAction <SecurityScopeActionType> -SecurityScopeName <String> [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: SetSecurityScopeByName
Set-CMApprovalRequest -ApplicationName <String[]> -SecurityScopeAction <SecurityScopeActionType> -SecurityScopeName <String> -User <String> [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: SetSecurityScopeByValue
Set-CMApprovalRequest -InputObject <IResultObject> -SecurityScopeAction <SecurityScopeActionType> -SecurityScopeName <String> [-Confirm] [-WhatIf] [ <CommonParameters>]

Detailed Description

The Set-CMApprovalRequest cmdlet changes an approval request for a Microsoft System Center 2012 Configuration Manager application. Administrators can require users who want to download an application to request administrative approval first. System Center 2012 Configuration Manager maintains a list of these requests. By default, System Center 2012 Configuration Manager removes any approval requests that you do not approve within 45 days and any approval requests from System Center 2012 Configuration Manager clients that you uninstall.

Parameters

-ApplicationName<String[]>

Specifies the name of the application for which users request access.

Aliases

Application

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-Id<String[]>

Specifies an array of IDs for the approval requests that you change.

Aliases

CIUniqueid

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-InputObject<IResultObject>

Specifies an approval request object. To obtain an approval request object, use the Get-CMApprovalRequest cmdlet.

Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-SecurityScopeAction<SecurityScopeActionType>

Specifies the type of the security scope action that you change for the request. Acceptable values for this parameter are AddMembership and RemoveMembership.

Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-SecurityScopeName<String>

Specifies the name of a new security scope for the request. The name can be Default or the name of a custom security scope.

Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-User<String>

Specifies the name of the user who requested access to the application.

Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-Confirm

Prompts you for confirmation before executing the command.

Required?

false

Position?

named

Default Value

false

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-WhatIf

Describes what would happen if you executed the command without actually executing the command.

Required?

false

Position?

named

Default Value

false

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

<CommonParameters>

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

Inputs

The input type is the type of the objects that you can pipe to the cmdlet.

Outputs

The output type is the type of the objects that the cmdlet emits.

Examples

Example 1: Get all approval requests

This command gets all approval requests from the System Center 2012 Configuration Manager database.

PS C:\> Get-CMApprovalRequest

Example 2: Get an approval request by using an ID

This command gets the approval request that has an ID of 1635223.

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

Example 3: Get approval requests from a user

This command gets all approval requests that the user who has the ID Western\SarahJones made for the application named HelloWorld.

PS C:\> Get-CMApprovalRequest -Application "HelloWorld" -User "Western\SarahJones" 

Approve-CMApprovalRequest

Deny-CMApprovalRequest

Get-CMApprovalRequest