Get-SCOMParentManagementServer

Get-SCOMParentManagementServer

Gets the management servers to which an agent reports.

Syntax

Parameter Set: FromAgent
Get-SCOMParentManagementServer [-Agent] <AgentManagedComputer[]> [ <CommonParameters>]

Parameter Set: FromGatewayManagementServer
Get-SCOMParentManagementServer [-GatewayServer] <ManagementServer[]> [ <CommonParameters>]

Detailed Description

The Get-SCOMParentManagementServer cmdlet retrieves the management servers to which an agent reports. In System Center 2012 – Operations Manager, primary and failover management servers provide redundancy for agents and gateway management servers.

Parameters

-Agent<AgentManagedComputer[]>

Specifies an array of one or more agent objects. For more information about how to get an agent object, type Get-Help Get-SCOMAgent.

Aliases

none

Required?

true

Position?

1

Default Value

none

Accept Pipeline Input?

true (ByValue)

Accept Wildcard Characters?

false

-GatewayServer<ManagementServer[]>

Specifies an array of gateway management servers. To obtain a ManagementServer object, use the Get-SCOMManagementServer cmdlet.

Aliases

none

Required?

true

Position?

1

Default Value

none

Accept Pipeline Input?

true (ByValue, ByPropertyName)

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 a list of management servers

This command retrieves the management servers to which the agent named Server01 reports.

The command in parentheses executes first and retrieves the agent named Server01. The cmdlet then uses the results of the command in parentheses as input to the Agent parameter.

PS C:\> Get-SCOMParentManagementServer -Agent (Get-SCOMAgent -Name "Server01.Contoso.com")

Example 2: Retrieve a list of management servers by wildcard

This example retrieves a list of management server for agent names that match a specific string.

The first command uses the Get-SCOMAgent cmdlet to get agents that begin with the string Server with a wildcard character. The cmdlet stores the agents in the $Agents variable.

The second command uses the Get-SCOMParentManagementServer cmdlet to get the management servers in the $Agents variable.

PS C:\> $Agents = "Server*.Contoso.com" | Get-SCOMAgent
PS C:\> Get-SCOMParentManagementServer -Agent $Agents

Example 3: Retrieve a list of management server using pipes

This command passes the agent named Server01.Consoso.com to the Get-SCOMAgent cmdlet by using the pipeline operator, and then passes the output to the Get-SCOMParentManagementServer cmdlet.

PS C:\> "Server01.Contoso.com" | Get-SCOMAgent | Get-SCOMParentManagementServer

Set-SCOMParentManagementServer

Get-SCOMAgent

Get-SCOMManagementServer