Set-SCOMParentManagementServer
Modifica los servidores de administración de conmutación por error y principal para un agente o un servidor de administración de puerta de enlace.
Sintaxis
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
El cmdlet Set-SCOMParentManagementServer
Este cmdlet requiere un objeto de agente o un objeto de servidor de administración de puerta de enlace y un objeto de servidor de administración.
Para obtener información sobre cómo obtener un objeto de agente, escriba Get-Help Get-SCOMAgent
.
Para obtener información sobre cómo obtener un objeto de servidor de administración de puerta de enlace, escriba "Get-Help Get-SCOMGatewayManagementServer
".
Este cmdlet no puede modificar tanto el servidor principal como el servidor de administración de conmutación por error en el mismo comando.
Ejemplos
Ejemplo 1: Establecimiento de los servidores de administración de conmutación por error y principal
$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
El script anterior establece la conmutación por error en $null y, a continuación, continúa para establecer los servidores principal y de conmutación por error. Esto es para evitar cualquier error al establecer el servidor principal o de conmutación por error en un nombre de servidor que ya esté establecido en los valores del servidor principal o de conmutación por error para los agentes.
Ejemplo 2: Establecer el servidor principal de puerta de enlace y el servidor de conmutación por error
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
En este ejemplo se establecen los servidores de administración primarios de puerta de enlace, principal y conmutación por error.
Los dos primeros comandos usan el cmdlet Get-SCOMManagementServer para obtener un servidor de administración que se establezca como servidor de administración principal del servidor de puerta de enlace y un servidor de administración para establecerlo como servidor de administración de conmutación por error del servidor de puerta de enlace. Los comandos almacenan los objetos en el $PrimaryMgmtServer y $FailoverMgmtServer variables, respectivamente.
El tercer comando usa el cmdlet Get-SCOMGatewayManagementServer para obtener el servidor de administración de puerta de enlace denominado GatewayMgmtServer01.Contoso.com y canaliza el resultado al cmdlet set-SCOMParentManagementServer de set-SCOMParentManagementServer para establecer el servidor de administración principal especificado en las variables de $PrimaryMgmtServer para el servidor de administración de puerta de enlace.
El cuarto comando usa el cmdlet get-SCOMGatewayManagementServer de
Ejemplo 3: Establecimiento del servidor de administración principal
PS C:\>Set-SCOMParentManagementServer -Agent (Get-SCOMAgent -Name "Server01.Contoso.com") -PrimaryServer (Get-SCOMManagementServer -Name "MgmtServer01.Contoso.com")
En este ejemplo se establece el servidor de administración principal para el agente especificado.
Los comandos entre paréntesis, que se ejecutan primero, obtienen el agente denominado Server01 y el servidor de administración denominado MgmtServer01. A continuación, el cmdlet pasa los resultados de los comandos entre paréntesis al cmdlet set-SCOMParentManagementServer , que luego establece el servidor principal para el agente.
Parámetros
-Agent
Especifica una matriz de objetos de agente.
Para obtener un objeto AgentManagedComputer de
Tipo: | AgentManagedComputer[] |
Posición: | 1 |
Valor predeterminado: | None |
Requerido: | True |
Aceptar entrada de canalización: | True |
Aceptar caracteres comodín: | False |
-Confirm
Le pide confirmación antes de ejecutar el cmdlet.
Tipo: | SwitchParameter |
Alias: | cf |
Posición: | Named |
Valor predeterminado: | False |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-FailoverServer
Especifica una matriz de objetos de servidor de administración que el agente usará como servidores de conmutación por error.
Para obtener información sobre cómo obtener un objeto de servidor de administración, escriba "Get-Help Get-SCOMManagementServer
".
Tipo: | ManagementServer[] |
Posición: | 2 |
Valor predeterminado: | None |
Requerido: | True |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-GatewayServer
Especifica una matriz de objetos del servidor de administración de puertas de enlace.
Para obtener información sobre cómo obtener un objeto de servidor de administración, escriba "Get-Help Get-SCOMGatewayManagementServer
".
Tipo: | ManagementServer[] |
Posición: | 1 |
Valor predeterminado: | None |
Requerido: | True |
Aceptar entrada de canalización: | True |
Aceptar caracteres comodín: | False |
-PassThru
Indica que el cmdlet crea o modifica un objeto que un comando puede usar en la canalización. De forma predeterminada, este cmdlet no genera ninguna salida.
Tipo: | SwitchParameter |
Posición: | 3 |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-PrimaryServer
Especifica una matriz de objetos de servidor de administración que el agente usará como servidor principal.
Tipo: | ManagementServer |
Posición: | 2 |
Valor predeterminado: | None |
Requerido: | True |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-WhatIf
Muestra lo que sucedería si el cmdlet se ejecuta. El cmdlet no se ejecuta.
Tipo: | SwitchParameter |
Alias: | wi |
Posición: | Named |
Valor predeterminado: | False |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
Notas
- No se pueden modificar los servidores de administración de conmutación por error y principal en el mismo comando. Para modificar ambos, ejecute Set-SCOMParentManagementServer dos veces, como se muestra en los ejemplos.