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 einen gezielten Computer installiert hat, wird keine Aktion ausgeführt.

Der erforderliche Agent-Parameter gibt die gezielt 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 Aktionen zum Aktualisieren von privilegierten Agents verwendet, während die angegebene WsManCredential für die Kommunikation mit niedriger Privilegierter 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 die Ergebnisse dann in der $WSCredential Variablen.

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 Run As-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 stellt temporäre Verbindungen mit Verwaltungsgruppen für diese Computer her. Sie können NetBIOS-Namen, IP-Adressen oder vollqualifizierte Domänennamen (FQDNs) verwenden. Um den lokalen Computer anzugeben, geben Sie 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 Cmdlet Get-Credential zurückgibt, für diesen Parameter. Geben Sie weitere Informationen zu Anmeldeinformationenobjekten ein Get-Help Get-Credential.

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. Verwenden Sie zum Abrufen von Connection-Objekten das Cmdlet Get-SCOMManagementGroupConnection.

Wenn dieser Parameter nicht angegeben ist, verwendet das Cmdlet die aktive dauerhafte Verbindung zu einer Verwaltungsgruppe. Verwenden Sie den SCSession-Parameter , um eine andere dauerhafte Verbindung anzugeben. Sie können eine temporäre Verbindung mit einer Verwaltungsgruppe mithilfe der Parameter "ComputerName " und "Anmeldeinformationen " erstellen. 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-Anmeldeinformationsobjekts geben Sie Get-Help Get-SCXSSHCredential.

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 niedriger Privilegierter Agent über WSMan verwendet werden. Dieses Cmdlet verwendet diese Anmeldeinformationen, um die Verfügbarkeit des Agents 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 übernimmt eine Auflistung von Hostnamen in aufgezählter Weise. Es sammelt alle Hostnamen und verarbeitet die gesamte Sammlung parallel am Ende der Pipeline.