Compartilhar via

Set-SCOMParentManagementServer

  • Referência
Módulo:
OperationsManager

Modifica os servidores de gerenciamento primário e de failover para um agente ou servidor de gerenciamento de gateway.

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

Description

O cmdlet Set-SCOMParentManagementServer modifica os servidores de gerenciamento primário e de failover para um servidor de gerenciamento de gateway ou agente. No System Center – Operations Manager, os servidores de gerenciamento primário e de failover fornecem redundância para agentes e servidores de gerenciamento de gateway.

Esse cmdlet requer um objeto de agente ou um objeto de servidor de gerenciamento de gateway e um objeto de servidor de gerenciamento. Para obter informações sobre como obter um objeto de agente, digite Get-Help Get-SCOMAgent. Para obter informações sobre como obter um objeto de servidor de gerenciamento de gateway, digite "Get-Help Get-SCOMGatewayManagementServer".

Esse cmdlet não pode modificar o servidor primário e o servidor de gerenciamento de failover no mesmo comando.

Exemplos

Exemplo 1: definir os servidores de gerenciamento primário e de failover

$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

O script acima define o failover como $null e, em seguida, prossegue para definir os servidores primários e de failover. Isso é para evitar qualquer erro ao definir o servidor primário ou de failover para um nome de servidor que já está definido nos valores de servidor primário ou de failover para os Agentes.

Exemplo 2: definir o servidor primário do gateway e o servidor de failover

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

Este exemplo define os servidores de gerenciamento pai de gateway, primário e failover.

Os dois primeiros comandos usam o cmdlet Get-SCOMManagementServer para que um servidor de gerenciamento seja definido como o servidor de gerenciamento primário do servidor de gateway e um servidor de gerenciamento a ser definido como o servidor de gerenciamento de failover do servidor de gateway. Os comandos armazenam os objetos no $PrimaryMgmtServer e $FailoverMgmtServer variáveis, respectivamente.

O terceiro comando usa o cmdlet Get-SCOMGatewayManagementServer para obter o servidor de gerenciamento de gateway chamado GatewayMgmtServer01.Contoso.com e redireciona o resultado para o cmdlet Set-SCOMParentManagementServer para definir o servidor de gerenciamento primário especificado nas variáveis $PrimaryMgmtServer para o servidor de gerenciamento de gateway.

O quarto comando usa o cmdlet Get-SCOMGatewayManagementServer para obter o servidor de gerenciamento de gateway chamado GatewayMgmtServer01.Contoso.com e redireciona o resultado para o cmdlet Set-SCOMParentManagementServer para definir o servidor de gerenciamento de failover especificado na variável $FailoverMgmtServer para o servidor de gerenciamento de gateway.

Exemplo 3: Definir o servidor de gerenciamento primário

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

Este exemplo define o servidor de gerenciamento primário para o agente especificado.

Os comandos entre parênteses, que são executados primeiro, recebem o agente chamado Server01 e o servidor de gerenciamento chamado MgmtServer01. Em seguida, o cmdlet passa os resultados dos comandos entre parênteses para o cmdlet Set-SCOMParentManagementServer , que define o servidor primário para o agente.

Parâmetros

-Agent

Especifica uma matriz de objetos de agente. Para obter um objeto AgentManagedComputer , use o cmdlet Get-SCOMADAgent .

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

-Confirm

Solicita sua confirmação antes de executar o cmdlet.

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

-FailoverServer

Especifica uma matriz de objetos de servidor de gerenciamento para o agente usar como servidores de failover. Para obter informações sobre como obter um objeto de servidor de gerenciamento, digite "Get-Help Get-SCOMManagementServer".

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

-GatewayServer

Especifica uma matriz de objetos de servidor de gerenciamento de gateway. Para obter informações sobre como obter um objeto de servidor de gerenciamento, digite "Get-Help Get-SCOMGatewayManagementServer".

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

-PassThru

Indica que o cmdlet cria ou modifica um objeto que um comando pode usar no pipeline. Por padrão, esse cmdlet não gera nenhuma saída

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

-PrimaryServer

Especifica uma matriz de objeto de servidor de gerenciamento para o agente usar como servidor primário.

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

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

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

Observações

  • Não é possível modificar os servidores de gerenciamento primário e de failover no mesmo comando. Para modificar ambos, execute Set-SCOMParentManagementServer duas vezes, conforme mostrado nos exemplos.