Get-SCOMPendingManagement
Get-SCOMPendingManagement
Retrieves pending agent management actions.
Syntax
Parameter Set: Empty
Get-SCOMPendingManagement [-ComputerName <String[]> ] [-Credential <PSCredential> ] [-SCSession <Connection[]> ] [ <CommonParameters>]
Detailed Description
The Get-SCOMPendingManagement cmdlet retrieves pending agent management actions in System Center 2012 – Operations Manager.
Parameters
-ComputerName<String[]>
Specifies an array of names of computers. The cmdlet establishes temporary connections with management groups for these computers. You can use NetBIOS names, IP addresses, or fully qualified domain names (FQDNs). To specify the local computer, type the computer name, localhost, or a dot (.).
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
true (ByValue) |
Accept Wildcard Characters? |
false |
-Credential<PSCredential>
Specifies a PSCredential object for the management group connection. To obtain a PSCredential object, use the Get-Credential cmdlet. For more information, type "Get-Help Get-Credential
".
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
true (ByValue) |
Accept Wildcard Characters? |
false |
-SCSession<Connection[]>
Specifies an array of Connection objects. To obtain a Connection object, use the Get-SCManagementGroupConnection cmdlet.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
true (ByValue) |
Accept Wildcard Characters? |
false |
<CommonParameters>
This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).
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: Retrieve all pending management entries
This command uses the Get-SCOMPendingManagement cmdlet to retrieve all pending management entries and sort them by the AgentName property.
PS C:\> Get-SCOMPendingManagement | Sort AgentName
Example 2: Retrieve pending management entries for a specific action
This command uses the Get-SCOMPendingManagement cmdlet to get the agent management entries that are pending with an action of ManualApproval, and sort the returned entries by the AgentName property.
PS C:\> Get-SCOMPendingManagement | where {$_.AgentPendingActionType -eq "ManualApproval"} | Sort AgentName
Example 3: Retrieve pending management entries and group by name
This command uses the Get-SCOMPendingManagement cmdlet to get all pending management entries, group them by their pending action type, and then sort them in descending order by the number of entries there are per action type group. The command then returns the action type group name and number of entries in each group.
PS C:\> Get-SCOMPendingManagement | Group AgentPendingActionType | Sort -Descending Count | Select-object Name, Count