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 cmdlet ändert die primären und Failoververwaltungsserver für einen Agent oder Gatewayverwaltungsserver. In System Center – Operations Manager bieten primäre und Failoververwaltungsserver Redundanz für Agents und Gatewayverwaltungsserver.
Für dieses Cmdlet ist ein Agentobjekt oder ein Gatewayverwaltungsserverobjekt und ein Verwaltungsserverobjekt erforderlich.
Geben Sie Get-Help Get-SCOMAgent
ein, um Informationen zum Abrufen eines Agentobjekts zu erhalten.
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 selben Befehl ändern.
Beispiele
Beispiel 1: Festlegen der primären und Failoververwaltungsserver
$PrimaryMgmtServer = Get-SCOMManagementServer -Name "MS01-2016.contoso.com"
$FailoverMgmtServer = Get-SCOMManagementServer -Name "MS02-2016.contoso.com"
$Agent1 = "AGENT01-2016.contoso.com" | Get-SCOMAgent
$Agent1 | Set-SCOMParentManagementServer -FailoverServer $null | Out-Null
$Agent1 | Set-SCOMParentManagementServer -PrimaryServer $PrimaryMgmtServer -Passthru
$Agent1 | Set-SCOMParentManagementServer -FailoverServer $FailoverMgmtServer -Passthru
$Agent2 = "DC01-2016.contoso.com" | Get-SCOMAgent
$Agent2 | Set-SCOMParentManagementServer -FailoverServer $null | Out-Null
$Agent2 | Set-SCOMParentManagementServer -PrimaryServer $PrimaryMgmtServer -Passthru
$Agent2 | Set-SCOMParentManagementServer -FailoverServer $FailoverMgmtServer -Passthru
Das obige Skript legt Failover auf $null fest und setzt dann fort, die primären und Failoverserver festzulegen. Dies ist das Verhindern eines Fehlers beim Festlegen des primären oder Failoverservers auf einen Servernamen, der bereits in den Primären- oder Failoverserverwerten für die Agents festgelegt 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 werden die Gateway-, primären und Failover-übergeordneten Verwaltungsserver festgelegt.
Die ersten beiden Befehle verwenden die Get-SCOMManagementServer Cmdlet, um einen Verwaltungsserver abzurufen, um als primären Verwaltungsserver des Gatewayservers festzulegen, und einen Verwaltungsserver, der als Failoververwaltungsserver des Gatewayservers festgelegt werden soll. Die Befehle speichern die Objekte in den $PrimaryMgmtServer und $FailoverMgmtServer Variablen.
Der dritte Befehl verwendet den Get-SCOMGatewayManagementServer Cmdlet, um den Gatewayverwaltungsserver mit dem Namen GatewayMgmtServer01.Contoso.com abzurufen und das Ergebnis an den Set-SCOMParentManagementServer Cmdlet zu übergeben, um den primären Verwaltungsserver festzulegen, der in den $PrimaryMgmtServer Variablen für den Gatewayverwaltungsserver angegeben ist.
Der vierte Befehl verwendet den Get-SCOMGatewayManagementServer Cmdlet, um den Gatewayverwaltungsserver mit dem Namen GatewayMgmtServer01.Contoso.com abzurufen und das Ergebnis an den Set-SCOMParentManagementServer Cmdlet zu übergeben, um den failoververwaltungsserver festzulegen, der in der variablen $FailoverMgmtServer 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 mit dem Namen Server01 und den Verwaltungsserver "MgmtServer01" ab. Anschließend übergibt das Cmdlet die Ergebnisse der Befehle in Klammern an das Cmdlet Set-SCOMParentManagementServer Cmdlet, 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.
Typ: | AgentManagedComputer[] |
Position: | 1 |
Standardwert: | None |
Erforderlich: | True |
Pipelineeingabe akzeptieren: | True |
Platzhalterzeichen akzeptieren: | False |
-Confirm
Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.
Typ: | SwitchParameter |
Aliase: | cf |
Position: | Named |
Standardwert: | False |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | 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.
Typ: | ManagementServer[] |
Position: | 2 |
Standardwert: | None |
Erforderlich: | True |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-GatewayServer
Gibt ein Array von Gatewayverwaltungsserverobjekten an.
Geben Sie "Get-Help Get-SCOMGatewayManagementServer
" ein, um Informationen zum Abrufen eines Verwaltungsserverobjekts zu erhalten.
Typ: | ManagementServer[] |
Position: | 1 |
Standardwert: | None |
Erforderlich: | True |
Pipelineeingabe akzeptieren: | True |
Platzhalterzeichen akzeptieren: | 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.
Typ: | SwitchParameter |
Position: | 3 |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-PrimaryServer
Gibt ein Array des Verwaltungsserverobjekts an, das für den Agent als primärer Server verwendet werden soll.
Typ: | ManagementServer |
Position: | 2 |
Standardwert: | None |
Erforderlich: | True |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-WhatIf
Zeigt, was passiert, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.
Typ: | SwitchParameter |
Aliase: | wi |
Position: | Named |
Standardwert: | False |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
Hinweise
- Sie können die primären und Failoververwaltungsserver nicht im selben Befehl ändern. Um beides zu ändern, führen Sie Set-SCOMParentManagementServer zweimal aus, wie in den Beispielen gezeigt.