Get-PrimaryManagementServer

Get-PrimaryManagementServer

Returns the primary management server.

Syntax

Parameter Set: FromAgentManagedComputer
Get-PrimaryManagementServer [-AgentManagedComputer] <AgentManagedComputer[]> [ <CommonParameters>]

Parameter Set: FromGatewayManagementServer
Get-PrimaryManagementServer [-GatewayManagementServer] <ManagementServer[]> [ <CommonParameters>]

Detailed Description

Returns the primary management server.

Parameters

-AgentManagedComputer<AgentManagedComputer[]>

The agent-managed computer for which to retrieve the primary management server.

Aliases

none

Required?

true

Position?

1

Default Value

none

Accept Pipeline Input?

true (ByValue)

Accept Wildcard Characters?

false

-GatewayManagementServer<ManagementServer[]>

The gateway management server for which to retrieve the primary management server.

Aliases

none

Required?

true

Position?

2

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

Notes

  • For more information, type "Get-Help Get-PrimaryManagementServer -detailed". For technical information, type "Get-Help Get-PrimaryManagementServer -full".
    When specifying multiple values for a parameter, use commas to separate the values. For example, "<parameter-name> <value1>, <value2>".

Examples

-------------- EXAMPLE 1 --------------

This example returns the principle names, versions, and IP addresses of the primary management servers.

C:\PS>Get-PrimaryManagementServer | ft PrincipalName, HealthState, IPAddress, Version

-------------- EXAMPLE 2 --------------

This example returns the primary management server for the specified agent.

C:\PS>Get-Agent | Get-PrimaryManagementServer

-------------- EXAMPLE 3 --------------

This example returns the primary management server for the specified gateway management server.

C:\PS>Get-GatewayManagementServer | Get-PrimaryManagementServer

Get-FailoverManagementServer

Get-GatewayManagementServer

Get-ManagementServer

Get-RootManagementServer