Freigeben über

Update-SCXAgent

  • Referenz
Modul:
OperationsManager

Aktualisiert den Verwaltungs-Agent auf den angegebenen UNIX- und Linux-Computern auf die neueste verfügbare Version.

Syntax

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

Beschreibung

Das Cmdlet Update-SCXAgent aktualisiert den Agent auf den angegebenen Computern auf die neueste verfügbare Version. Wenn die neueste verfügbare Version des Verwaltungs-Agents bereits ein zielorientierter Computer installiert ist, wird keine Aktion ausgeführt.

Der erforderliche Agent-Parameter gibt die zielorientierte verwalteten UNIX- und Linux-Computer an, die deinstalliert werden sollen, und erfordert ein UNIX- und Linux-Computerobjekt. Informationen zum Abrufen verwalteter UNIX- und Linux-Computer finden Sie im Cmdlet Get-SCXAgent. Dieses Cmdlet akzeptiert SshCredential - und WsManCredential-Eingabeparameter . Der angegebene SshCredential-Parameter wird für privilegierte Agent-Updateaktionen verwendet, während die angegebene WsManCredential für die Kommunikation mit niedrig privilegierten Agent verwendet wird. Wenn der SshCredential-Parameter nicht bereitgestellt wird, versucht das Cmdlet, die definierte Agent-Wartung als Konto zu verwenden, das dem zielbezogenen Computer zugeordnet ist.

Die Ausgabe dieses Cmdlets ist ein Array von verwalteten UNIX- oder Linux-Computerobjekten, die die zielbezogenen Systeme darstellen, die erfolgreich aktualisiert wurden.

Beispiele

Beispiel 1: Aktualisieren eines Verwaltungs-Agents

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

Der erste Befehl ruft den Agent für einen verwalteten Linux- oder UNIX-Computer namens nx1.contoso.com mithilfe des Cmdlets Get-SCXAgent ab. Der Befehl speichert sie in der Variablen $Agent 01.

Der zweite Befehl ruft eine Anmeldeinformationen für einen Benutzer mithilfe des Cmdlets Get-Credential ab. Der Befehl fordert Sie zur Authentifizierung auf, und speichert dann die Ergebnisse in der $WSCredential Variable.

Der dritte Befehl erstellt eine privilegierte Anmeldeinformationen für einen Benutzer mithilfe des Cmdlets Get-SCXSSHCredential. Der Befehl speichert das Ergebnis in der $SSHCredential Variablen.

Der letzte Befehl aktualisiert den Verwaltungs-Agent in $Agent 01 mit den Werten aus den zweiten und dritten Befehlen.

Beispiel 2: Aktualisieren eines Verwaltungs-Agents mit dem definierten Ausführen als Konto

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

Dieser Befehl ruft den Agent für einen verwalteten Linux- oder UNIX-Computer namens nx1.contoso.com mithilfe von Get-SCXAgent ab. Der Befehl übergibt den verwalteten Computer an das aktuelle Cmdlet. Der Befehl aktualisiert den Verwaltungs-Agent mithilfe des definierten Run As-Kontos.

Parameter

-Agent

Gibt mindestens ein verwaltetes UNIX- oder Linux-Computerobjekt an. Informationen zum Abrufen eines verwalteten UNIX- oder Linux-Computerobjekts finden Sie unter Get-Help Get-SCXAgent".

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

-ComputerName

Gibt ein Array von Namen von Computern an. Das Cmdlet erstellt temporäre Verbindungen mit Verwaltungsgruppen für diese Computer. Sie können NetBIOS-Namen, IP-Adressen oder vollqualifizierte Domänennamen (FQDNs) verwenden. Geben Sie zum Angeben des lokalen Computers den Computernamen, localhost oder einen Punkt (.) ein.

Der System Center Data Access-Dienst muss auf dem Computer aktiv sein. Wenn Sie keinen Computer angeben, verwendet das Cmdlet den Computer für die aktuelle Verwaltungsgruppenverbindung.

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

-Confirm

Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.

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

-Credential

Gibt das Benutzerkonto an, unter dem die Verwaltungsgruppenverbindung ausgeführt wird. Geben Sie ein PSCredential-Objekt an, z. B. eins, das das Get-Credential-Cmdlet zurückgibt, für diesen Parameter. Weitere Informationen zu Anmeldeinformationenobjekten geben Sie Get-Help Get-Credentialein.

Wenn Sie einen Computer im ComputerName-Parameter angeben, verwenden Sie ein Konto, das Zugriff auf diesen Computer hat. Der Standardwert ist der aktuelle Benutzer.

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

-SCSession

Gibt ein Array von Connection-Objekten an. Um Verbindungsobjekte abzurufen, verwenden Sie das Cmdlet Get-SCOMManagementGroupConnection .

Wenn dieser Parameter nicht angegeben wird, verwendet das Cmdlet die aktive persistente Verbindung zu einer Verwaltungsgruppe. Verwenden Sie den SCSession-Parameter , um eine andere persistente Verbindung anzugeben. Sie können eine temporäre Verbindung zu einer Verwaltungsgruppe erstellen, indem Sie die Parameter "ComputerName " und "Anmeldeinformationen " verwenden. Geben Sie Folgendes ein, um weitere Informationen zu erhalten: Get-Help about_OpsMgr_Connections.

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

-SshCredential

Gibt einen privilegierten SshCredential-Parameter an, der zum Ausführen der Agent-Updateaktionen verwendet wird. Wenn dieser Parameter nicht angegeben ist, versucht das Cmdlet, die definierte Agent-Wartung als Konto für den Agent zu verwenden.

Informationen zum Abrufen eines SSH-Anmeldeinformationenobjekts finden Sie Get-Help Get-SCXSSHCredentialunter ".

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

-WhatIf

Zeigt, was geschieht, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

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

-WsManCredential

Gibt eine Anmeldeinformationen an, die für die Kommunikation mit niedrig privilegiertem Agent über WSMan verwendet werden. Dieses Cmdlet verwendet diese Anmeldeinformationen, um die Verfügbarkeit des Agent zu überprüfen.

Geben Sie einen Benutzernamen ein, z. B. "User01", oder geben Sie ein PSCredential-Objekt ein, z. B. ein Objekt, das vom Cmdlet Get-Credential zurückgegeben wird. Wenn Sie einen Benutzernamen eingeben, werden Sie zur Eingabe eines Kennworts aufgefordert.

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

Ausgaben

Microsoft.Unix.Computer[]

Dieses Cmdlet gibt eine Sammlung von Upgradeergebnissen zurück, die jeweils den Upgradestatus für einen Computer darstellen. Jedes Ergebnis muss die folgenden Informationen enthalten:

  • Hostname
  • Betriebssysteme
  • Alte Agent-Version
  • Neue Agent-Version
  • Status der Aktualisierung
  • BESCHREIBUNG

Die Beschreibung enthält die Details, warum ein Upgrade fehlgeschlagen ist.

Hinweise

  • Dieses Cmdlet nimmt eine Sammlung von Hostnamen in aufgezählter Weise ein. Es sammelt alle Hostnamen und verarbeitet die gesamte Auflistung parallel am Ende der Pipeline.