Install-SCOMAgent
Implementa agentes de Operations Manager.
Sintaxis
Default (Es el valor predeterminado).
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
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 obtener un objeto de de Get-Help Get-Credential.
Propiedades del parámetro
| Tipo: | PSCredential |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-AgentActionAccount
Especifica un objeto de de 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.
Propiedades del parámetro
| Tipo: | PSCredential |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-Confirm
Le pide confirmación antes de ejecutar el cmdlet.
Propiedades del parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | False |
| Admite caracteres comodín: | False |
| DontShow: | False |
| Alias: | cf |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-DNSHostName
Especifica el nombre de un host del sistema de nombres de dominio (DNS).
Propiedades del parámetro
| Tipo: | String[] |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
| Alias: | Nombre |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | True |
| Valor de la canalización: | True |
| Valor de la canalización por nombre de propiedad: | True |
| Valor de los argumentos restantes: | 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.
Propiedades del parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | 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.
Propiedades del parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-PrimaryManagementServer
Especifica un objeto
Propiedades del parámetro
| Tipo: | ManagementServer |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | True |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-WhatIf
Muestra lo que sucedería si el cmdlet se ejecuta. El cmdlet no se ejecuta.
Propiedades del parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | False |
| Admite caracteres comodín: | False |
| DontShow: | False |
| Alias: | Wi |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
CommonParameters
Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.