Set-SCOMParentManagementServer
Modifica os servidores de gerenciamento primário e de failover para um agente ou servidor de gerenciamento de gateway.
Sintaxe
FromAgentPrimaryServer (Predefinição)
Set-SCOMParentManagementServer
[-Agent] <AgentManagedComputer[]>
[-PrimaryServer] <ManagementServer>
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
FromAgentFailoverServer
Set-SCOMParentManagementServer
[-Agent] <AgentManagedComputer[]>
[-FailoverServer] <ManagementServer[]>
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
FromGatewayManagementServer
Set-SCOMParentManagementServer
[-PrimaryServer] <ManagementServer>
[-GatewayServer] <ManagementServer[]>
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
FromGatewayFailoverManagementServer
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 de 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".
Este 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ário e de failover. Isso é para evitar qualquer erro ao definir o servidor primário ou de failover para um nome de servidor que já esteja 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 obter um servidor de gerenciamento para definir como o servidor de gerenciamento primário do servidor gateway e um servidor de gerenciamento para definir como o servidor de gerenciamento de failover do servidor 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 $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 canaliza 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, 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
Parâmetros
-Agent
Especifica uma matriz de objetos de agente.
Para obter um objeto
Propriedades dos parâmetros
| Tipo: | AgentManagedComputer[] |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
FromAgentPrimaryServer
| Position: | 1 |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline por nome de propriedade: | True |
| Valor dos restantes argumentos: | False |
FromAgentFailoverServer
| Position: | 1 |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline por nome de propriedade: | True |
| Valor dos restantes argumentos: | False |
-Confirm
Solicita confirmação antes de executar o cmdlet.
Propriedades dos parâmetros
| Tipo: | SwitchParameter |
| Default value: | False |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
| Aliases: | Cf. |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-FailoverServer
Especifica uma matriz de objetos do 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".
Propriedades dos parâmetros
| Tipo: | ManagementServer[] |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
FromAgentFailoverServer
| Position: | 2 |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
FromGatewayFailoverManagementServer
| Position: | 2 |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | 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".
Propriedades dos parâmetros
| Tipo: | ManagementServer[] |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
FromGatewayManagementServer
| Position: | 1 |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline por nome de propriedade: | True |
| Valor dos restantes argumentos: | False |
FromGatewayFailoverManagementServer
| Position: | 1 |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline por nome de propriedade: | True |
| Valor dos restantes argumentos: | 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
Propriedades dos parâmetros
| Tipo: | SwitchParameter |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | 3 |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-PrimaryServer
Especifica uma matriz de objeto de servidor de gerenciamento para o agente usar como seu servidor primário.
Propriedades dos parâmetros
| Tipo: | ManagementServer |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
FromAgentPrimaryServer
| Position: | 2 |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-WhatIf
Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.
Propriedades dos parâmetros
| Tipo: | SwitchParameter |
| Default value: | False |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
| Aliases: | Wi |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
CommonParameters
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.
Notas
- 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.