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"