Update-SCXAgent
Actualiza el agente de administración en los equipos UNIX y Linux especificados a la versión más reciente disponible.
Syntax
Update-SCXAgent
-Agent <IPersistedUnixComputer[]>
[-WsManCredential <PSCredential>]
[-SshCredential <CredentialSet>]
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
El cmdlet Update-SCXAgent actualiza el agente en los equipos especificados a la versión más reciente disponible. Si la versión más reciente disponible del agente de administración ya está instalada en un equipo de destino, no se realiza ninguna acción.
El parámetro Agent necesario especifica los equipos UNIX y Linux administrados de destino que se van a desinstalar y requiere un objeto de equipo UNIX y Linux. Para obtener información sobre cómo recuperar equipos UNIX y Linux administrados, consulte el cmdlet Get-SCXAgent. Este cmdlet acepta los parámetros de entrada SshCredential y WsManCredential . El parámetro SshCredential proporcionado se usa para las acciones de actualización del agente con privilegios, mientras que WsManCredential proporcionado se usa para la comunicación con agentes con pocos privilegios. Si no se proporciona el parámetro SshCredential , el cmdlet intenta usar la cuenta de ejecución de mantenimiento del agente definida asociada al equipo de destino.
La salida de este cmdlet es una matriz de objetos de equipo UNIX o Linux administrados que representan los sistemas de destino que se actualizaron correctamente.
Ejemplos
Ejemplo 1: Actualización de un agente de administración
PS C:\>$Agent01 = Get-SCXAgent -Name "nx1.contoso.com"
PS C:\> $WSCredential = Get-Credential "DavidChew"
PS C:\> $SSHCredential = Get-SCXSSHCredential -UserName "DavidChew" -Key "C:\keys\key21.ppk" -ElevationType sudo
PS C:\> Update-SCXAgent -SSHCredential $SSHCredential -WSManCredential $WSCredential -Agent $Agent01
El primer comando obtiene el agente de un equipo Linux o UNIX administrado denominado nx1.contoso.com mediante el cmdlet Get-SCXAgent. El comando lo almacena en la variable $Agent 01.
El segundo 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 tercer comando crea una credencial con privilegios para un usuario mediante el cmdlet Get-SCXSSHCredential. El comando almacena el resultado en la variable $SSHCredential.
El comando final actualiza el agente de administración en $Agent 01 con los valores de los comandos segundo y tercero.
Ejemplo 2: Actualización de un agente de administración con la cuenta de ejecución definida
PS C:\>Get-SCXAgent -Name "nx1.contoso.com" | Update-SCXAgent
Este comando obtiene el agente de un equipo Linux o UNIX administrado denominado nx1.contoso.com mediante Get-SCXAgent. El comando pasa el equipo administrado al cmdlet actual. El comando actualiza el agente de administración mediante la cuenta de ejecución definida.
Parámetros
-Agent
Especifica uno o varios objetos de equipo UNIX o Linux administrados.
Para obtener información sobre cómo obtener un objeto de equipo UNIX o Linux administrado, escriba Get-Help Get-SCXAgent
.
Type: | IPersistedUnixComputer[] |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-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 en 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 |
-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 |
-SshCredential
Especifica un parámetro SshCredential con privilegios que se usa para realizar las acciones de actualización del agente. Si no se especifica este parámetro, el cmdlet intenta usar la cuenta de ejecución de mantenimiento del agente definida para el agente.
Para obtener información sobre cómo obtener un objeto de credencial SSH, escriba Get-Help Get-SCXSSHCredential
.
Type: | CredentialSet |
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 |
-WsManCredential
Especifica una credencial usada para la comunicación con agentes con pocos privilegios a través de WSMan. Este cmdlet usa esta credencial para comprobar la disponibilidad del agente.
Escriba un nombre de usuario, como User01 o escriba un objeto PSCredential , como uno devuelto por el cmdlet Get-Credential. Cuando escriba un nombre de usuario, se le solicitará una contraseña.
Type: | PSCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Salidas
Microsoft.Unix.Computer[]
Este cmdlet devuelve una colección de resultados de actualización, cada uno que representa el estado de actualización de un equipo. Cada resultado debe contener la siguiente información:
- Hostname
- Sistemas operativos
- Versión del agente anterior
- Nueva versión del agente
- estado de actualización
- Descripción
La descripción incluye los detalles de por qué se produjo un error en una actualización.
Notas
- Este cmdlet toma una colección de nombres de host de forma enumerada. Recopila todos los nombres de host y procesa toda la colección en paralelo al final de la canalización.