Install-SCXAgent
Instala el agente de Operations Manager para los equipos UNIX y Linux detectados.
Sintaxis
Default (Es el valor predeterminado).
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 los equipos UNIX y Linux detectados, firma el certificado para WS-Management comunicación y registra el agente con Operations Manager para su 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: Detección de equipos UNIX y Linux e instalación del 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 solicita la 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.
Propiedades del parámetro
| Tipo: | String[] |
| 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 |
-Credential
Especifica la cuenta de usuario con la que se ejecuta la conexión del grupo de administración.
Especifique un objeto PSCredential , como uno que devuelva el cmdlet Get-Credential , para este parámetro.
Para obtener más información acerca de los objetos de credencial, 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.
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 |
-DiscoveryResult
Especifica el objeto DiscoveryResult que se va a procesar para la instalación del agente de administración tal y como lo devuelve el cmdlet Invoke-SCXDiscovery .
Para obtener más información sobre cómo detectar sistemas de destino, escriba Get-Help Invoke-SCXDiscovery.
Propiedades del parámetro
| Tipo: | DiscoveryResult[] |
| 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: | True |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | 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.
Utilice 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.
Propiedades del parámetro
| Tipo: | Connection[] |
| 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 |
-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.
Salidas
Microsoft.Unix.Computer
Este cmdlet devuelve una matriz de equipos UNIX y Linux administrados que se instalaron correctamente.