Partager via

Set-SCOMParentManagementServer

  • Référence
Module:
OperationsManager

Modifie les serveurs d’administration principaux et de basculement d’un agent ou d’un serveur d’administration de passerelle.

Syntaxe

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

Description

L’applet de commande Set-SCOMParentManagementServer modifie les serveurs d’administration principaux et de basculement pour un serveur d’administration d’agent ou de passerelle. Dans System Center - Operations Manager, les serveurs d’administration principaux et de basculement fournissent une redondance pour les agents et les serveurs d’administration de passerelle.

Cette applet de commande nécessite un objet agent ou un objet serveur d’administration de passerelle et un objet serveur d’administration. Pour plus d’informations sur l’obtention d’un objet agent, tapez Get-Help Get-SCOMAgent. Pour plus d’informations sur l’obtention d’un objet serveur d’administration de passerelle, tapez «Get-Help Get-SCOMGatewayManagementServer».

Cette applet de commande ne peut pas modifier le serveur principal et le serveur d’administration de basculement dans la même commande.

Exemples

Exemple 1 : Définir les serveurs d’administration principaux et de basculement

$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

Le script ci-dessus définit le basculement sur $null, puis passe à la définition des serveurs principaux et de basculement. Cela permet d’éviter toute erreur lors de la définition du serveur principal ou du serveur de basculement sur un nom de serveur déjà défini dans les valeurs du serveur principal ou du serveur de basculement pour les agents.

Exemple 2 : Définir le serveur principal de passerelle et le serveur de basculement

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

Cet exemple montre comment définir les serveurs d’administration parents de passerelle, principaux et de basculement.

Les deux premières commandes utilisent l’applet de commande Get-SCOMManagementServer pour obtenir un serveur d’administration à définir comme serveur d’administration principal du serveur de passerelle et un serveur d’administration à définir comme serveur d’administration de basculement du serveur de passerelle. Les commandes stockent les objets dans les variables $PrimaryMgmtServer et $FailoverMgmtServer, respectivement.

La troisième commande utilise la cmdlet Get-SCOMGatewayManagementServer pour obtenir le serveur d’administration de passerelle nommé GatewayMgmtServer01.Contoso.com et canalise le résultat vers l’applet de commande Set-SCOMParentManagementServer pour définir le serveur d’administration principal spécifié dans les variables $PrimaryMgmtServer pour le serveur d’administration de passerelle.

La quatrième commande utilise la cmdlet Get-SCOMGatewayManagementServer pour obtenir le serveur d’administration de passerelle nommé GatewayMgmtServer01.Contoso.com et canalise le résultat vers la cmdlet Set-SCOMParentManagementServer pour définir le serveur d’administration de basculement spécifié dans la variable $FailoverMgmtServer pour le serveur d’administration de passerelle.

Exemple 3 : Définir le serveur d’administration principal

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

Cet exemple montre comment définir le serveur d’administration principal de l’agent spécifié.

Les commandes entre parenthèses, qui sont exécutées en premier, obtiennent l’agent nommé Server01 et le serveur d’administration nommé MgmtServer01. L’applet de commande transmet ensuite les résultats des commandes entre parenthèses au Set-SCOMParentManagementServer cmdlet, qui définit ensuite le serveur principal de l’agent.

Paramètres

-Agent

Spécifie un tableau d’objets d’agent. Pour obtenir un objet AgentManagedComputer , utilisez l’applet de commande Get-SCOMADAgent Get-SCOMADAgent.

Type:AgentManagedComputer[]
Position:1
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-Confirm

Vous invite à confirmer avant d’exécuter l’applet de commande.

Type:SwitchParameter
Alias:cf
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-FailoverServer

Spécifie un tableau d’objets de serveur d’administration que l’agent doit utiliser comme serveurs de basculement. Pour plus d’informations sur l’obtention d’un objet serveur d’administration, tapez «Get-Help Get-SCOMManagementServer».

Type:ManagementServer[]
Position:2
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-GatewayServer

Spécifie un tableau d’objets de serveur d’administration de passerelle. Pour plus d’informations sur l’obtention d’un objet serveur d’administration, tapez «Get-Help Get-SCOMGatewayManagementServer».

Type:ManagementServer[]
Position:1
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-PassThru

Indique que l’applet de commande crée ou modifie un objet qu’une commande peut utiliser dans le pipeline. Par défaut, cette applet de commande ne génère aucune sortie

Type:SwitchParameter
Position:3
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-PrimaryServer

Spécifie un tableau d’objets de serveur d’administration que l’agent doit utiliser comme serveur principal.

Type:ManagementServer
Position:2
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-WhatIf

Affiche ce qui se passerait si l’applet de commande s’exécute. L’applet de commande n’est pas exécutée.

Type:SwitchParameter
Alias:wi
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

Notes

  • Vous ne pouvez pas modifier les serveurs d’administration principaux et de basculement dans la même commande. Pour modifier les deux, exécutez Set-SCOMParentManagementServer deux fois, comme illustré dans les exemples.