Delen via

Update-SCXAgent

  • Referentie
Module:
OperationsManager

Hiermee wordt de beheeragent op de opgegeven UNIX- en Linux-computers bijgewerkt naar de nieuwste versie die beschikbaar is.

Syntaxis

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

Description

De cmdlet Update-SCXAgent werkt de agent op de opgegeven computers bij naar de nieuwste beschikbare versie. Als de meest recente beschikbare versie van de beheeragent al een doelcomputer is geïnstalleerd, wordt er geen actie ondernomen.

De vereiste Agent parameter specificeert de doel beheerde UNIX- en Linux-computers om te verwijderen en vereist een UNIX- en Linux-computerobject. Zie de cmdlet Get-SCXAgent voor informatie over het ophalen van beheerde UNIX- en Linux-computers. Deze cmdlet accepteert SshCredential- en WsManCredential invoerparameters. De opgegeven SshCredential- parameter wordt gebruikt voor updateacties van bevoegde agents terwijl de opgegeven WsManCredential- wordt gebruikt voor communicatie met beperkte agents. Als de parameter SshCredential niet is opgegeven, probeert de cmdlet het Uitvoeren als-account van de gedefinieerde agent te gebruiken dat is gekoppeld aan de doelcomputer.

De uitvoer van deze cmdlet is een matrix met beheerde UNIX- of Linux-computerobjecten die de doelsystemen vertegenwoordigen die zijn bijgewerkt.

Voorbeelden

Voorbeeld 1: Een beheeragent bijwerken

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

Met de eerste opdracht haalt u de agent op voor een beheerde Linux- of UNIX-computer met de naam nx1.contoso.com met behulp van de Get-SCXAgent-cmdlet. Met de opdracht wordt deze opgeslagen in de variabele $Agent 01.

Met de tweede opdracht wordt een referentie voor een gebruiker ophaalt met behulp van de cmdlet Get-Credential. De opdracht vraagt u om verificatie en slaat vervolgens de resultaten op in de $WSCredential variabele.

Met de derde opdracht maakt u een bevoegde referentie voor een gebruiker met behulp van de Get-SCXSSHCredential-cmdlet. Met de opdracht wordt het resultaat opgeslagen in de $SSHCredential variabele.

Met de laatste opdracht wordt de beheeragent in $Agent 01 bijgewerkt met de waarden van de tweede en derde opdracht.

Voorbeeld 2: Een beheeragent bijwerken met het gedefinieerde Uitvoeren als-account

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

Met deze opdracht haalt u de agent op voor een beheerde Linux- of UNIX-computer met de naam nx1.contoso.com met behulp van Get-SCXAgent. De opdracht geeft de beheerde computer door aan de huidige cmdlet. Met de opdracht wordt de beheeragent bijgewerkt met behulp van het gedefinieerde Uitvoeren als-account.

Parameters

-Agent

Hiermee geeft u een of meer beheerde UNIX- of Linux-computerobjecten op. Typ Get-Help Get-SCXAgentvoor informatie over het ophalen van een beheerd UNIX- of Linux-computerobject.

Type:IPersistedUnixComputer[]
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-ComputerName

Hiermee geeft u een matrix van namen van computers. Met de cmdlet worden tijdelijke verbindingen met beheergroepen voor deze computers tot stand gebracht. U kunt NetBIOS-namen, IP-adressen of FQDN's (Fully Qualified Domain Names) gebruiken. Als u de lokale computer wilt opgeven, typt u de computernaam, localhost of een punt (.).

De System Center Data Access-service moet actief zijn op de computer. Als u geen computer opgeeft, gebruikt de cmdlet de computer voor de huidige beheergroepverbinding.

Type:String[]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Confirm

U wordt gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type:SwitchParameter
Aliassen:cf
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Credential

Hiermee geeft u het gebruikersaccount waaronder de verbinding met de beheergroep wordt uitgevoerd. Geef een PSCredential--object op, zoals een object dat door de Get-Credential cmdlet wordt geretourneerd voor deze parameter. Typ Get-Help Get-Credentialvoor meer informatie over referentieobjecten.

Als u een computer opgeeft in de parameter ComputerName, gebruikt u een account dat toegang heeft tot die computer. De standaardwaarde is de huidige gebruiker.

Type:PSCredential
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-SCSession

Hiermee geeft u een matrix van Connection-objecten. Gebruik de cmdlet Get-SCOMManagementGroupConnection om Connection-objecten op te halen.

Als deze parameter niet is opgegeven, gebruikt de cmdlet de actieve permanente verbinding met een beheergroep. Gebruik de parameter SCSession om een andere permanente verbinding op te geven. U kunt een tijdelijke verbinding met een beheergroep maken met behulp van de parameters ComputerName en Credential. Typ Get-Help about_OpsMgr_Connectionsvoor meer informatie.

Type:Connection[]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-SshCredential

Hiermee geeft u een bevoegde SshCredential parameter die wordt gebruikt voor het uitvoeren van de agent updateacties. Als deze parameter niet is opgegeven, probeert de cmdlet het uitvoeren als-account van de agent te gebruiken voor het uitvoeren als-account van de agent.

Typ Get-Help Get-SCXSSHCredentialvoor informatie over het ophalen van een SSH-referentieobject.

Type:CredentialSet
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-WhatIf

Toont wat er zou gebeuren als de cmdlet wordt uitgevoerd. De cmdlet wordt niet uitgevoerd.

Type:SwitchParameter
Aliassen:wi
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-WsManCredential

Hiermee geeft u een referentie die wordt gebruikt voor communicatie met beperkte bevoegdheden via WSMan. Deze cmdlet gebruikt deze referentie om de beschikbaarheid van de agent te controleren.

Typ een gebruikersnaam, zoals User01 of voer een PSCredential--object in, zoals een object dat wordt geretourneerd door de Get-Credential-cmdlet. Wanneer u een gebruikersnaam typt, wordt u gevraagd om een wachtwoord.

Type:PSCredential
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

Uitvoerwaarden

Microsoft.Unix.Computer[]

Deze cmdlet retourneert een verzameling upgraderesultaten, die elk de upgradestatus voor een computer vertegenwoordigen. Elk resultaat moet de volgende informatie bevatten:

  • Hostnaam
  • Besturingssystemen
  • Oude agentversie
  • Nieuwe agentversie
  • upgradestatus
  • Beschrijving

De beschrijving bevat de details van waarom een upgrade is mislukt.

Notities

  • Deze cmdlet neemt een verzameling hostnamen op geïnventariseerd wijze. Het verzamelt alle hostnamen en verwerkt de volledige verzameling parallel aan het einde van de pijplijn.