Set-SCOMParentManagementServer
Modifica os servidores de gerenciamento primário e de failover para um agente ou servidor de gerenciamento de gateway.
Sintaxe
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 agente ou servidor de gerenciamento de gateway. 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, continua a 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 do 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 canaliza o resultado para o cmdlet Set-SCOMParentManagementServer para definir o servidor de gerenciamento primário especificado nas variáveis de $PrimaryMgmtServer para o servidor de gerenciamento de gateway.
O quarto comando usa o cmdlet
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, obtêm 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.
Tipo: | AgentManagedComputer[] |
Cargo: | 1 |
Valor padrão: | None |
Obrigatório: | True |
Aceitar a entrada de pipeline: | True |
Aceitar caracteres curinga: | False |
-Confirm
Solicita a confirmação antes de executar o cmdlet.
Tipo: | SwitchParameter |
Aliases: | cf |
Cargo: | Named |
Valor padrão: | False |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | 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
".
Tipo: | ManagementServer[] |
Cargo: | 2 |
Valor padrão: | None |
Obrigatório: | True |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-GatewayServer
Especifica uma matriz de objetos do servidor de gerenciamento de gateway.
Para obter informações sobre como obter um objeto de servidor de gerenciamento, digite "Get-Help Get-SCOMGatewayManagementServer
".
Tipo: | ManagementServer[] |
Cargo: | 1 |
Valor padrão: | None |
Obrigatório: | True |
Aceitar a entrada de pipeline: | True |
Aceitar caracteres curinga: | 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
Tipo: | SwitchParameter |
Cargo: | 3 |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-PrimaryServer
Especifica uma matriz de objeto de servidor de gerenciamento para o agente usar como servidor primário.
Tipo: | ManagementServer |
Cargo: | 2 |
Valor padrão: | None |
Obrigatório: | True |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-WhatIf
Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.
Tipo: | SwitchParameter |
Aliases: | wi |
Cargo: | Named |
Valor padrão: | False |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
Observações
- Você não pode 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.