Install-SCXAgent

Referencia

Módulo:: OperationsManager

Instala el agente de Operations Manager para equipos UNIX y Linux detectados.

Syntax

Install-SCXAgent
       -DiscoveryResult <DiscoveryResult[]>
       [-SCSession <Connection[]>]
       [-ComputerName <String[]>]
       [-Credential <PSCredential>]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]

Description

El cmdlet Install-SCXAgent instala el agente de Operations Manager para equipos UNIX y Linux detectados, firma el certificado para WS-Management comunicación y registra el agente con Operations Manager para la administración. Los equipos UNIX y Linux deben detectarse con el cmdlet Invoke-SCXDiscovery. El objeto de salida del cmdlet Invoke-SCXDiscovery se proporciona como entrada DiscoveryResult para el cmdlet Install-SCXAgent .

Para obtener información sobre cómo detectar equipos UNIX o Linux, escriba Get-Help Invoke-SCXDiscovery.

Este cmdlet devuelve una matriz de objetos de equipo UNIX o Linux administrados que representan los sistemas de destino que se instalaron correctamente.

Ejemplos

Ejemplo 1: Detectar equipos UNIX y Linux e instalar el agente de administración

PS C:\>$WSCredential = Get-Credential "DavidChew"
PS C:\> $SSHCredential = Get-SCXSSHCredential -UserName "DavidChew" -Key "C:\keys\key21.ppk" -ElevationType sudo
PS C:\> $Pool01 = Get-SCOMResourcePool -DisplayName "Pool01"
PS C:\> Invoke-SCXDiscovery -IPRange 192.168.1.50,192.168.1.75 -ResourcePool $MyPool -WSManCredential $WSCredential -SSHCredential $SSHCredential | Install-SCXAgent

El primer comando obtiene una credencial para un usuario mediante el cmdlet Get-Credential. El comando le pide autenticación y, a continuación, almacena los resultados en la variable $WSCredential.

El segundo comando crea una credencial con privilegios para un usuario mediante el cmdlet Get-SCXSSHCredential. El comando almacena el resultado en la variable $SSHCredential.

El tercer comando obtiene un grupo de recursos denominado Pool01 mediante el cmdlet Get-SCOMResourcePool y, a continuación, lo almacena en la variable $Pool 01.

El comando final invoca una detección de equipos UNIX y Linux dentro de un intervalo de direcciones IP mediante el cmdlet Invoke-SCXDiscovery. El comando pasa los equipos detectados al cmdlet actual mediante el operador de canalización. El comando instala el agente de administración.

Parámetros

-ComputerName

Especifica una matriz de nombres de equipos. El cmdlet establece conexiones temporales con grupos de administración para estos equipos. Puede usar nombres netBIOS, direcciones IP o nombres de dominio completos (FQDN). Para especificar el equipo local, escriba el nombre del equipo, localhost o un punto (.).

El servicio de acceso a datos de System Center debe estar activo en el equipo. Si no especifica un equipo, el cmdlet usa el equipo para la conexión del grupo de administración actual.

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

Le solicita su confirmación antes de ejecutar el cmdlet.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Credential

Especifica la cuenta de usuario con la que se ejecuta la conexión del grupo de administración. Especifique un objeto PSCredential , como el que devuelve el cmdlet Get-Credential , para este parámetro. Para obtener más información sobre los objetos de credenciales, escriba Get-Help Get-Credential.

Si especifica un equipo en el parámetro ComputerName , use una cuenta que tenga acceso a ese equipo. El valor predeterminado es el usuario actual.

Type:	PSCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DiscoveryResult

Especifica el objeto DiscoveryResult que se va a procesar para la instalación del agente de administración tal y como devuelve el cmdlet Invoke-SCXDiscovery .

Para obtener más información sobre cómo detectar sistemas de destino, escriba Get-Help Invoke-SCXDiscovery.

Type:	DiscoveryResult[]
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-SCSession

Especifica una matriz de objetos Connection . Para obtener objetos Connection , use el cmdlet Get-SCOMManagementGroupConnection .

Si no se especifica este parámetro, el cmdlet usa la conexión persistente activa a un grupo de administración. Use el parámetro SCSession para especificar una conexión persistente diferente. Puede crear una conexión temporal a un grupo de administración mediante los parámetros ComputerName y Credential . Para obtener más información, escriba Get-Help about_OpsMgr_Connections.

Type:	Connection[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

Muestra lo que sucedería si se ejecutara el cmdlet. El cmdlet no se ejecuta.

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Salidas

Microsoft.Unix.Computer[]

Este cmdlet devuelve una matriz de equipos UNIX y Linux administrados que se instalaron correctamente.