Compartir a través de

Install-SCOMAgent

  • Referencia
Módulo:
OperationsManager

Implementa agentes de Operations Manager.

Sintaxis

Install-SCOMAgent
       -ActionAccount <PSCredential>
       [-AgentActionAccount <PSCredential>]
       -DNSHostName <String[]>
       -PrimaryManagementServer <ManagementServer>
       [-NoAPM]
       [-PassThru]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]

Description

El cmdlet Install-SCOMAgent implementa uno o varios agentes de versión de producto de System Center 2019 Operations Manager y versiones posteriores mediante la instalación de inserción de cliente. Nota: El parámetro [-NoAPM] se presenta con System Center Operations Manager 1807 (este parámetro no es válido con System Center 2019 Operations Manager).

Ejemplos

Ejemplo 1: Instalación de un agente en un servidor

PS C:\>$PrimaryMgmtServer = Get-SCOMManagementServer -ComputerName "MgmtServer01.Contoso.com"
PS C:\> Install-SCOMAgent -DNSHostName "server01.contoso.com" -PrimaryManagementServer $PrimaryMgmtServer

En este ejemplo se instala un agente en un servidor y se establece el servidor de administración principal para el agente.

El primer comando obtiene el objeto del servidor de administración denominado MgmtServer01.Contoso.com y almacena el objeto en la variable $PrimaryMgmtServer.

El segundo comando instala un agente en Server01.Contoso.com y establece su servidor de administración principal en el servidor de administración almacenado en $PrimaryMgmtServer.

Ejemplo 2: Instalación de un agente en un servidor mediante las credenciales de la cuenta de acción

PS C:\>$InstallAccount = Get-Credential
PS C:\> $PrimaryMgmtServer = Get-SCOMManagementServer -ComputerName "MgmtServer01.Contoso.com"
PS C:\> Install-SCOMAgent -DNSHostName "Server01.Contoso.com" -PrimaryManagementServer $PrimaryMgmtServer -ActionAccount $InstallAccount

En este ejemplo se solicita al usuario que escriba las credenciales y, a continuación, use las credenciales para instalar un agente.

El primer comando solicita al usuario las credenciales y almacena las credenciales en la variable $InstallAccount.

El segundo comando obtiene el objeto del servidor de administración denominado MgmtServer01.Contoso.com y almacena el objeto en la variable $PrimaryMgmtServer.

El tercer comando instala un agente en Server01.Contoso.com mediante las credenciales almacenadas en $InstallAccount y establece el servidor de administración principal para el agente en el servidor de administración almacenado en $PrimaryMgmtServer.

Ejemplo 3: Instalación de un agente en servidores y establecimiento de la cuenta de acción del agente

PS C:\>$Agents = "DC1.contoso.com","DC2.contoso.com","DC3.contoso.com"
PS C:\> $InstallAccount = Get-Credential
PS C:\> $AgentActionAccount = Get-Credential Contoso\ActionAccount
PS C:\> $PrimaryMgmtServer = Get-SCOMManagementserver -ComputerName MgmtServer01.contoso.com
PS C:\> $Install-SCOMAgent -DNSHostName $Agents -PrimaryManagementServer $PrimaryMgmtServer -ActionAccount $InstallAccount -AgentActionAccount $AgentActionAccount -Confirm

En este ejemplo se instalan agentes en tres equipos y se establece la cuenta de acción del agente para los agentes.

El primer comando almacena el nombre de tres equipos en la variable $Agents.

El segundo comando solicita al usuario las credenciales y almacena las credenciales en la variable $InstallAccount.

El tercer comando solicita al usuario una contraseña para una cuenta de usuario denominada ActionAccount en el dominio contoso y almacena las credenciales en la variable $AgentActionAccount.

El cuarto comando obtiene el objeto de servidor de administración denominado MgmtServer01.Contoso.com y almacena el objeto en la variable $PrimaryMgmtServer.

El quinto comando instala un agente en los tres equipos almacenados en la variable $Agents mediante las credenciales almacenadas en $InstallAccount. El comando establece el servidor de administración principal del agente en el servidor de administración almacenado en $PrimaryMgmtServer y establece la cuenta de acción del agente en el usuario ActionAccount almacenado en $AgentActionAccount.

Parámetros

-ActionAccount

Especifica un objeto de de PSCredential. Este parámetro especifica las credenciales que Operations Manager usa para ejecutar la tarea de implementación. Este es un parámetro obligatorio. Si especifica un valor NULL, Operations Manager usa la cuenta de acción predeterminada del servidor de administración para el agente.

Este parámetro no especifica la cuenta de acción que el agente usa después de instalarlo en el equipo. De forma predeterminada, la cuenta de acción que usa el agente se establece en Sistema local. Puede usar el parámetro agentActionAccount de para cambiar la cuenta de acción que usa el agente.

Para obtener un objeto de de PSCredential, use el cmdlet get-credential de . Para obtener más información, escriba Get-Help Get-Credential.

Tipo:PSCredential
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-AgentActionAccount

Especifica un objeto de de PSCredential. Este parámetro especifica la cuenta de acción que usa el agente después de instalarlo en el equipo. De forma predeterminada, la cuenta de acción que usa el agente se establece en Sistema local. Para obtener un objeto de de PSCredential, use el cmdlet get-credential de . Para obtener más información, escriba Get-Help Get-Credential. Puede usar el cmdlet Get-SCOMRunAsProfile para obtener una cuenta de ejecución que puede usar para la cuenta de acción.

Tipo:PSCredential
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
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

-DNSHostName

Especifica el nombre de un host del sistema de nombres de dominio (DNS).

Tipo:String[]
Alias:Name
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-NoAPM

Se trata de un parámetro opcional introducido con System Center Operations Manager 1807 (este parámetro no es válido con System Center 2019 Operations Manager), que permite elegir la instalación del componente de APM en el agente. Use este parámetro para omitir la instalación del componente de APM en el agente.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
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:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-PrimaryManagementServer

Especifica un objeto ManagementServer. Este parámetro especifica el servidor de administración principal para el agente. Para obtener un objeto ManagementServer, use el cmdlet get-SCOMManagementServer de .

Tipo:ManagementServer
Posición:Named
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