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-SCOMManagementGroupConnection 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

Approve-SCOMPendingManagement

Deny-SCOMPendingManagement

Get-Credential

Get-SCOMManagementGroupConnection