Update-SCXAgent
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 Zielcomputer installiert hat, wird keine Aktion ausgeführt.
Der erforderliche Agent Parameter gibt die zielverwalteten 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 bereitgestellte SshCredential Parameter wird für Aktualisierungsaktionen des privilegierten Agents verwendet, während die bereitgestellten WsManCredential- für die Kommunikation mit agents mit niedriger Berechtigung verwendet werden. Wenn der Parameter SshCredential nicht angegeben wird, versucht das Cmdlet, die definierte Agent-Wartung als Konto zu verwenden, das dem Zielcomputer 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 $Agent01Der erste Befehl ruft den Agent für einen verwalteten Linux- oder UNIX-Computer mit dem Namen nx1.contoso.com mithilfe des cmdlets Get-SCXAgent ab. Der Befehl speichert sie in der Variablen $Agent 01.
Der zweite Befehl ruft mithilfe des cmdlets Get-Credential eine Anmeldeinformationen für einen Benutzer ab. Die Eingabeaufforderungen für die Authentifizierung und speichern dann die Ergebnisse in der variablen $WSCredential.
Der dritte Befehl erstellt mithilfe des Cmdlets Get-SCXSSHCredential eine privilegierte Anmeldeinformationen für einen Benutzer. Der Befehl speichert das Ergebnis in der variablen $SSHCredential.
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 Konto "Ausführen als"
PS C:\>Get-SCXAgent -Name "nx1.contoso.com" | Update-SCXAgentDieser Befehl ruft den Agent für einen verwalteten Linux- oder UNIX-Computer mit dem Namen nx1.contoso.com mithilfe von Get-SCXAgentab. Der Befehl übergibt den verwalteten Computer an das aktuelle Cmdlet. Mit dem Befehl wird der Verwaltungs-Agent mithilfe des definierten Kontos "Ausführen als" aktualisiert.
Parameter
-Agent
Gibt mindestens ein verwaltetes UNIX- oder Linux-Computerobjekt an.
Um Informationen zum Abrufen eines verwalteten UNIX- oder Linux-Computerobjekts zu erhalten, geben Sie Get-Help Get-SCXAgentein.
| Typ: | IPersistedUnixComputer[] |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |
-ComputerName
Gibt ein Array von Namen von Computern an. Das Cmdlet richtet temporäre Verbindungen mit Verwaltungsgruppen für diese Computer ein. Sie können NetBIOS-Namen, IP-Adressen oder vollqualifizierte Domänennamen (FQDNs) verwenden. Um den lokalen Computer anzugeben, geben Sie den Computernamen, den 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.
| Typ: | String[] |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-Confirm
Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.
| Typ: | SwitchParameter |
| Aliase: | cf |
| Position: | Named |
| Standardwert: | False |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-Credential
Gibt das Benutzerkonto an, unter dem die Verwaltungsgruppenverbindung ausgeführt wird.
Geben Sie für diesen Parameter ein PSCredential--Objekt an, z. B. ein Objekt, das vom Get-Credential--Cmdlet zurückgegeben wird.
Wenn Sie weitere Informationen zu Anmeldeinformationsobjekten wünschen, geben Sie Get-Help Get-Credentialein.
Wenn Sie einen Computer im parameter ComputerName angeben, verwenden Sie ein Konto, das Zugriff auf diesen Computer hat. Die Standardeinstellung ist der aktuelle Benutzer.
| Typ: | PSCredential |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-SCSession
Gibt ein Array von Connection -Objekten an. Um Connection-Objekte abzurufen, verwenden Sie 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 erstellen, indem Sie die Parameter ComputerName und Anmeldeinformationen verwenden.
Geben Sie Get-Help about_OpsMgr_Connectionsein, um weitere Informationen zu erfahren.
| Typ: | Connection[] |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-SshCredential
Gibt einen privilegierten SshCredential Parameter an, der zum Ausführen der Agentaktualisierungsaktionen verwendet wird. Wenn dieser Parameter nicht angegeben ist, versucht das Cmdlet, die definierte Agent-Wartung als Konto für den Agent zu verwenden.
Um Informationen zum Abrufen eines SSH-Anmeldeinformationsobjekts zu erhalten, geben Sie Get-Help Get-SCXSSHCredentialein.
| Typ: | CredentialSet |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-WhatIf
Zeigt, was passiert, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.
| Typ: | SwitchParameter |
| Aliase: | wi |
| Position: | Named |
| Standardwert: | False |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-WsManCredential
Gibt eine Anmeldeinformation an, die für die Kommunikation mit Agent mit niedriger Berechtigung über WSMan verwendet wird. 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 aufgefordert, ein Kennwort einzugeben.
| Typ: | PSCredential |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | 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
- Upgradestatus
- Beschreibung
Die Beschreibung enthält die Details, warum ein Upgrade fehlgeschlagen ist.
Hinweise
- Dieses Cmdlet verwendet eine Auflistung von Hostnamen in aufgezählter Weise. Es sammelt alle Hostnamen und verarbeitet die gesamte Sammlung parallel am Ende der Pipeline.