Reject-QARSApprovalTask
From PowerGUI Wiki
Apply the Reject resolution on approval tasks for which you are assigned to the Approver role in ActiveRoles Server.
This cmdlet is part of the Quest ActiveRoles Server product. Use Get-QARSProductInfo to view information about ActiveRoles Server.
Contents |
Syntax
Reject-QARSApprovalTask [-Task] <TaskIdentityParameter> -Reason <string> [-Connection <ArsConnection>] [-ConnectionAccount <string>] [-ConnectionPassword <SecureString>] [-Credential <PSCredential>] [-Proxy] [-Service <string>] [-UseGlobalCatalog] [-Confirm] [-WhatIf] [<CommonParameters>]
Detailed Description
Use this cmdlet to reject change requests that require your approval in ActiveRoles Server. You can take an object returned by the Get-QARSApprovalTask cmdlet and pipe that object into this cmdlet in order to complete the respective approval task with the Reject resolution.
Every change request that requires your approval has an approval task for you to allow or deny the requested changes. When you complete your approval task with the Reject resolution, you effectively deny the changes, preventing them from being applied. Note that the changes may also require approval by other persons. In this case, the changes are not applied if any one of the approval tasks is completed with the Reject resolution. For more information about approval tasks, see description of the Get-QARSApprovalTask cmdlet.
The cmdlet has optional parameters that determine the server and the security context for the operation. The connection parameters could be omitted since a connection to a server is normally established prior to using this cmdlet. In this case, the server and the security context are determined by the Connect-QADService cmdlet.
If you do not use Connect-QADService and have no connection established prior to using a cmdlet, then the connection settings, including the server and the security context, are determined by the connection parameters of the first cmdlet you use. Subsequent cmdlets will use those settings by default.
Note that this cmdlet requires a connection to the ActiveRoles Server Administration Service, so the Proxy parameter must be used to establish a connection.
Parameters
| Name | Description | Required? | Pipeline Input | Default Value |
|---|---|---|---|---|
| Connection | For parameter description, see help on the Connect-QADService cmdlet. | false | false | |
| ConnectionAccount | For parameter description, see help on the Connect-QADService cmdlet. | false | false | |
| ConnectionPassword | For parameter description, see help on the Connect-QADService cmdlet. | false | false | |
| Credential | For parameter description, see help on the Connect-QADService cmdlet. | false | false | |
| Proxy | For parameter description, see help on the Connect-QADService cmdlet. | false | false | |
| Reason | Supply any text you want to comment your decision. This text is saved by ActiveRoles Server for reporting and audit purposes, and can be accesses through the respective property of the ApprovalTask object. | true | false | |
| Service | For parameter description, see help on the Connect-QADService cmdlet. | false | false | |
| Task | Pass an object returned by the Get-QARSApprovalTask cmdlet to this parameter. This parameter also accepts the numeric ID of an approval task (you can view task ID in the Approval section of the ActiveRoles Server Web Interface). | true | true (ByValue) | |
| UseGlobalCatalog | For parameter description, see help on the Connect-QADService cmdlet. | false | false | |
| Confirm | Prompts you for confirmation before executing the command. | false | false | |
| WhatIf | Describes what would happen if you executed the command without actually executing the command. | false | false |
Examples
EXAMPLE 1
Get-QARSOperation -TargetObject 'domainName\userName' -InitiatedOn 'Today' -OperationStatus Pending |
%{Get-QARSApprovalTask -Operation $_ -ApproverIsMe} |
Reject-QARSApprovalTask
Description
Reject all changes to a particular user account that were requested on the current date and are awaiting approval by the current user.
EXAMPLE 2
Get-QARSOperation -TargetObject 'domainName\userName' -InitiatedBy 'MyDomain\JohnSmith' -OperationStatus Pending |
%{Get-QARSApprovalTask -Operation $_ -ApproverIsMe} |
Reject-QARSApprovalTask
Description
Reject all changes to a particular user account that were requested by the user 'MyDomain\JohnSmith' and are awaiting approval by the current user.
