Set-SCOMParentManagementServer

Ändert die primären und Failoververwaltungsserver für einen Agent oder Gatewayverwaltungsserver.

Syntax

Set-SCOMParentManagementServer
   [-Agent] <AgentManagedComputer[]>
   [-PrimaryServer] <ManagementServer>
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-SCOMParentManagementServer
   [-Agent] <AgentManagedComputer[]>
   [-FailoverServer] <ManagementServer[]>
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-SCOMParentManagementServer
   [-PrimaryServer] <ManagementServer>
   [-GatewayServer] <ManagementServer[]>
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-SCOMParentManagementServer
   [-GatewayServer] <ManagementServer[]>
   [-FailoverServer] <ManagementServer[]>
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Beschreibung

Das Cmdlet Set-SCOMParentManagementServer ändert die primären und Failoververwaltungsserver für einen Agent oder Gatewayverwaltungsserver. In System Center 2019 – Operations Manager bieten primäre und Failoververwaltungsserver Redundanz für Agents und Gatewayverwaltungsserver.

Dieses Cmdlet erfordert ein Agentobjekt oder ein Gatewayverwaltungsserverobjekt und ein Verwaltungsserverobjekt. Informationen zum Abrufen eines Agentobjekts finden Sie unter Get-Help Get-SCOMAgent. Geben Sie "Get-Help Get-SCOMGatewayManagementServer" ein, um Informationen zum Abrufen eines Gatewayverwaltungsserverobjekts zu erhalten.

Dieses Cmdlet kann nicht sowohl den primären Server als auch den Failoververwaltungsserver im gleichen Befehl ändern.

Beispiele

Beispiel 1: Festlegen der primären und Failoververwaltungsserver

PS C:\>$PrimaryMgmtServer = Get-SCOMManagementServer -Name "MgmtServer01.Contoso.com"
PS C:\> $FailoverMgmtServer = Get-SCOMManagementServer -Name "MgmtServer02.Contoso.com"
PS C:\> "Server01.Contoso.com" | Get-SCOMAgent | Set-SCOMParentManagementServer -PrimaryServer $PrimaryMgmtServer -Passthru
PS C:\> "Server01.Contoso.com" | Get-SCOMAgent | Set-SCOMParentManagementServer -FailoverServer $FailoverMgmtServer -Passthru

In diesem Beispiel wird der primäre und failover übergeordnete Verwaltungsserver festgelegt.

Die ersten beiden Befehle verwenden das Cmdlet Get-SCOMManagementServer , um einen Verwaltungsserver abzurufen, der als primärer Verwaltungsserver des Agents festgelegt wird, und einen Verwaltungsserver, der als Failoververwaltungsserver des Agents festgelegt wird. Die Befehle speichern die Objekte in den $PrimaryMgmtServer und $FailoverMgmtServer Variablen.

Der dritte Befehl verwendet das Cmdlet Get-SCOMAgent , um den Agent mit dem Namen Server01.Contoso.com abzurufen und das Ergebnis mithilfe des Pipelineoperators an das Cmdlet Set-SCOMParentManagementServer zu übergeben. Der Befehl legt den primären Verwaltungsserver fest, der in der variablen $PrimaryMgmtServer angegeben ist. Anschließend wird der PassThru-Parameter verwendet, um ein Objekt zu generieren. Ohne den PassThru-Parameter generiert Set-SCOMParentManagementServer keine Ausgabe.

Der vierte Befehl legt den Failoververwaltungsserver fest, der in der variablen $FailoverMgmtServer angegeben ist.

Beispiel 2: Festlegen des primären Gatewayservers und des Failoverservers

PS C:\>$PrimaryMgmtServer = Get-SCOMManagementServer -name "MgmtServer01.Contoso.com"
PS C:\> $FailoverMgmtServer = Get-SCOMManagementServer -Name "MgmtServer02.Contoso.com"
PS C:\> "GatewayMgmtServer01.Contoso.com" | Get-SCOMGatewayManagementServer | Set-SCOMParentManagementServer -PrimaryServer $PrimaryMgmtServer
PS C:\> "GatewayMgmtServer01.Contoso.com" | Get-SCOMGatewayManagementServer | Set-SCOMParentManagementServer -FailoverServer $FailoverMgmtServer

In diesem Beispiel wird das Gateway, die primären und failover übergeordneten Verwaltungsserver festgelegt.

Die ersten beiden Befehle verwenden das Cmdlet Get-SCOMManagementServer , um einen Verwaltungsserver abzurufen, um den primären Verwaltungsserver des Gatewayservers festzulegen, und einen Verwaltungsserver, der als Failoververwaltungsserver des Gatewayservers festgelegt wird. Die Befehle speichern die Objekte in den $PrimaryMgmtServer und $FailoverMgmtServer Variablen.

Der dritte Befehl verwendet das Cmdlet Get-SCOMGatewayManagementServer , um den Gatewayverwaltungsserver mit dem Namen GatewayMgmtServer01.Contoso.com abzurufen und das Ergebnis an das Cmdlet Set-SCOMParentManagementServer zu übergeben, um den primären Verwaltungsserver festzulegen, der in den $PrimaryMgmtServer Variablen für den Gatewayverwaltungsserver angegeben ist.

Der vierte Befehl verwendet das Cmdlet Get-SCOMGatewayManagementServer , um den Gatewayverwaltungsserver namens GatewayMgmtServer01.Contoso.com abzurufen und das Ergebnis an das Cmdlet Set-SCOMParentManagementServer zu übergeben, um den failoververwaltungsserver festzulegen, der in der $FailoverMgmtServer Variablen für den Gatewayverwaltungsserver angegeben ist.

Beispiel 3: Festlegen des primären Verwaltungsservers

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

In diesem Beispiel wird der primäre Verwaltungsserver für den angegebenen Agent festgelegt.

Die Befehle in Klammern, die zuerst ausgeführt werden, rufen den Agent namens Server01 und den Verwaltungsserver mit dem Namen MgmtServer01 ab. Das Cmdlet übergibt dann die Ergebnisse der Befehle in Klammern an das Cmdlet Set-SCOMParentManagementServer , das dann den primären Server für den Agent festlegt.

Parameter

-Agent

Gibt ein Array von Agentobjekten an. Um ein AgentManagedComputer-Objekt abzurufen, verwenden Sie das Cmdlet Get-SCOMADAgent .

Type:AgentManagedComputer[]
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Confirm

Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-FailoverServer

Gibt ein Array von Verwaltungsserverobjekten für den Agent an, der als Failoverserver verwendet werden soll. Geben Sie "Get-Help Get-SCOMManagementServer" ein, um Informationen zum Abrufen eines Verwaltungsserverobjekts zu erhalten.

Type:ManagementServer[]
Position:2
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-GatewayServer

Gibt ein Array von Gatewayverwaltungsserverobjekten an. Geben Sie "Get-Help Get-SCOMGatewayManagementServer" ein, um Informationen zum Abrufen eines Verwaltungsserverobjekts zu erhalten.

Type:ManagementServer[]
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-PassThru

Gibt an, dass das Cmdlet ein Objekt erstellt oder ändert, das ein Befehl in der Pipeline verwenden kann. Standardmäßig generiert dieses Cmdlet keine Ausgabe

Type:SwitchParameter
Position:3
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PrimaryServer

Gibt ein Array des Verwaltungsserverobjekts an, das für den Agent als primärer Server verwendet werden soll.

Type:ManagementServer
Position:2
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Zeigt, was geschieht, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Hinweise

  • Sie können nicht sowohl die primären als auch die Failoververwaltungsserver im gleichen Befehl ändern. Um beides zu ändern, führen Sie Set-SCOMParentManagementServer zweimal aus, wie in den Beispielen gezeigt.