Dela via

Update-SCXAgent

  • Referens
Modul:
OperationsManager

Uppgraderar hanteringsagenten på de angivna UNIX- och Linux-datorerna till den senaste tillgängliga versionen.

Syntax

Update-SCXAgent
      -Agent <IPersistedUnixComputer[]>
      [-WsManCredential <PSCredential>]
      [-SshCredential <CredentialSet>]
      [-SCSession <Connection[]>]
      [-ComputerName <String[]>]
      [-Credential <PSCredential>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

Cmdleten Update-SCXAgent uppdaterar agenten på de angivna datorerna till den senaste tillgängliga versionen. Om den senaste tillgängliga versionen av hanteringsagenten redan är installerad på en måldator vidtas ingen åtgärd.

Den nödvändiga Agent-parametern anger de hanterade UNIX- och Linux-datorerna som ska avinstalleras och kräver ett UNIX- och Linux-datorobjekt. Information om hur du hämtar hanterade UNIX- och Linux-datorer finns i cmdleten Get-SCXAgent. Den här cmdleten accepterar SshCredential- och WsManCredential indataparametrar. Den angivna parametern SshCredential används för privilegierade agentuppdateringsåtgärder medan den angivna WsManCredential- används för kommunikation med lågprivilegierad agent. Om parametern SshCredential inte tillhandahålls försöker cmdleten använda det definierade kör som-konto för agentunderhåll som är associerat med måldatorn.

Utdata från den här cmdleten är en matris med hanterade UNIX- eller Linux-datorobjekt som representerar målsystemen som har uppdaterats.

Exempel

Exempel 1: Uppdatera en hanteringsagent

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

Det första kommandot hämtar agenten för en hanterad Linux- eller UNIX-dator med namnet nx1.contoso.com med hjälp av cmdleten Get-SCXAgent. Kommandot lagrar det i variabeln $Agent 01.

Det andra kommandot hämtar en autentiseringsuppgift för en användare med hjälp av cmdleten Get-Credential. Kommandot frågar dig om autentisering och lagrar sedan resultatet i variabeln $WSCredential.

Det tredje kommandot skapar en privilegierad autentiseringsuppgift för en användare med hjälp av cmdleten Get-SCXSSHCredential. Kommandot lagrar resultatet i variabeln $SSHCredential.

Det sista kommandot uppdaterar hanteringsagenten i $Agent 01 med värdena från de andra och tredje kommandona.

Exempel 2: Uppdatera en hanteringsagent med det definierade Kör som-kontot

PS C:\>Get-SCXAgent -Name "nx1.contoso.com" | Update-SCXAgent

Det här kommandot hämtar agenten för en hanterad Linux- eller UNIX-dator med namnet nx1.contoso.com med hjälp av Get-SCXAgent. Kommandot skickar den hanterade datorn till den aktuella cmdleten. Kommandot uppdaterar hanteringsagenten med det definierade Kör som-kontot.

Parametrar

-Agent

Anger ett eller flera hanterade UNIX- eller Linux-datorobjekt. Om du vill ha information om hur du hämtar ett hanterat UNIX- eller Linux-datorobjekt skriver du Get-Help Get-SCXAgent.

Typ:IPersistedUnixComputer[]
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-ComputerName

Anger en matris med namn på datorer. Cmdleten upprättar tillfälliga anslutningar med hanteringsgrupper för dessa datorer. Du kan använda NetBIOS-namn, IP-adresser eller fullständigt kvalificerade domännamn (FQDN). Om du vill ange den lokala datorn skriver du datornamnet, localhost eller en punkt (.).

System Center Data Access-tjänsten måste vara aktiv på datorn. Om du inte anger någon dator använder cmdleten datorn för den aktuella hanteringsgruppens anslutning.

Typ:String[]
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

Typ:SwitchParameter
Alias:cf
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Credential

Anger det användarkonto under vilket anslutningen till hanteringsgruppen körs. Ange ett PSCredential- objekt, till exempel ett objekt som cmdleten Get-Credential returnerar för den här parametern. Om du vill ha mer information om autentiseringsobjekt skriver du Get-Help Get-Credential.

Om du anger en dator i parametern ComputerName använder du ett konto som har åtkomst till datorn. Standardvärdet är den aktuella användaren.

Typ:PSCredential
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-SCSession

Anger en matris med Anslutning objekt. Om du vill hämta anslutningsobjekt använder du cmdleten Get-SCOMManagementGroupConnection.

Om den här parametern inte anges använder cmdleten den aktiva beständiga anslutningen till en hanteringsgrupp. Använd parametern SCSession för att ange en annan beständig anslutning. Du kan skapa en tillfällig anslutning till en hanteringsgrupp med hjälp av parametrarna ComputerName och Credential. Om du vill ha mer information skriver du Get-Help about_OpsMgr_Connections.

Typ:Connection[]
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-SshCredential

Anger en privilegierad SshCredential parameter som används för att utföra agentuppdateringsåtgärderna. Om den här parametern inte anges försöker cmdleten använda det definierade kör som-kontot för agentunderhåll för agenten.

Om du vill ha information om hur du hämtar ett SSH-autentiseringsobjekt skriver du Get-Help Get-SCXSSHCredential.

Typ:CredentialSet
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-WhatIf

Visar vad som skulle hända om cmdleten körs. Cmdleten körs inte.

Typ:SwitchParameter
Alias:wi
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-WsManCredential

Anger en autentiseringsuppgift som används för kommunikation med lågprivilegierade agenter via WSMan. Den här cmdleten använder den här autentiseringsuppgiften för att verifiera agenttillgängligheten.

Ange ett användarnamn, till exempel User01 eller ange ett PSCredential- objekt, till exempel ett objekt som returneras av cmdleten Get-Credential. När du skriver ett användarnamn uppmanas du att ange ett lösenord.

Typ:PSCredential
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

Utdata

Microsoft.Unix.Computer[]

Den här cmdleten returnerar en samling uppgraderingsresultat som var och en representerar uppgraderingsstatusen för en dator. Varje resultat måste innehålla följande information:

  • Värdnamn
  • Operativsystem
  • Gammal agentversion
  • Ny agentversion
  • uppgraderingsstatus
  • Beskrivning

Beskrivningen innehåller information om varför en uppgradering misslyckades.

Kommentarer

  • Den här cmdleten tar in en samling värdnamn på uppräknat sätt. Den samlar in alla värdnamn och bearbetar hela samlingen parallellt i slutet av pipelinen.