Compartir a través de

Update-SCXAgent

  • Referencia
Módulo:
OperationsManager

Actualiza el agente de administración en los equipos UNIX y Linux especificados a la versión más reciente disponible.

Sintaxis

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 agente de 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 SshCredential y parámetros de entrada WsManCredential. El parámetro sshCredential proporcionado se usa para las acciones de actualización del agente con privilegios, mientras que el 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 para 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.

Tipo:IPersistedUnixComputer[]
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín: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.

Tipo:String[]
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

-Credential

Especifica la cuenta de usuario en la que se ejecuta la conexión del grupo de administración. Especifique un objeto de PSCredential, como el que devuelve el cmdlet get-credential de , 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.

Tipo:PSCredential
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín: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 el computerName de y parámetros de Credential. Para obtener más información, escriba Get-Help about_OpsMgr_Connections.

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

-SshCredential

Especifica un parámetro de sshCreden tial 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.

Tipo:CredentialSet
Posición:Named
Valor predeterminado:None
Requerido:False
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

-WsManCredential

Especifica una credencial que se usa para la comunicación de agente 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 de PSCredential, como uno devuelto por el cmdlet Get-Credential. Al escribir un nombre de usuario, se le pedirá una contraseña.

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

  • Nombre de host
  • 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 de 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.