Sdílet prostřednictvím

Update-SCXAgent

  • Reference
Modul:
OperationsManager

Upgraduje agenta pro správu na zadaných počítačích se systémem UNIX a Linux na nejnovější dostupnou verzi.

Syntax

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

Description

Rutina Update-SCXAgent aktualizuje agenta na zadaných počítačích na nejnovější dostupnou verzi. Pokud je už nainstalovaná nejnovější dostupná verze agenta pro správu, není provedena žádná akce.

Požadovaný parametr agenta určuje cílové spravované počítače se systémem UNIX a Linux k odinstalaci a vyžaduje objekt počítače se systémem UNIX a Linux. Informace o načítání spravovaných počítačů se systémem UNIX a Linux najdete v Get-SCXAgent rutině. Tato rutina přijímá vstupní parametry SshCredential a WsManCredential . Zadaný parametr SshCredential se používá pro akce aktualizace privilegovaného agenta, zatímco zadané WsManCredential se používá pro komunikaci s agenty s nízkou úrovní oprávnění. Pokud parametr SshCredential není zadán, rutina se pokusí použít definovaný účet údržby agenta Spustit jako přidružený k cílovému počítači.

Výstupem této rutiny je pole spravovaných objektů počítačů se systémem UNIX nebo Linux představující cílové systémy, které byly úspěšně aktualizovány.

Příklady

Příklad 1: Aktualizace agenta pro správu

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

První příkaz získá agenta pro spravovaný počítač se systémem Linux nebo UNIX s názvem nx1.contoso.com pomocí rutiny Get-SCXAgent. Příkaz ho uloží do proměnné $Agent 01.

Druhý příkaz získá přihlašovací údaje pro uživatele pomocí rutiny Get-Credential. Příkaz vás vyzve k ověření a pak uloží výsledky do proměnné $WSCredential.

Třetí příkaz vytvoří privilegované přihlašovací údaje pro uživatele pomocí rutiny Get-SCXSSHCredential. Příkaz uloží výsledek do proměnné $SSHCredential.

Poslední příkaz aktualizuje agenta pro správu v $Agent 01 hodnotami z druhého a třetího příkazu.

Příklad 2: Aktualizace agenta pro správu s definovaným účtem Spustit jako

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

Tento příkaz získá agenta pro spravovaný počítač se systémem Linux nebo UNIX s názvem nx1.contoso.com pomocí Get-SCXAgent. Příkaz předá spravovaný počítač aktuální rutině. Příkaz aktualizuje agenta pro správu pomocí definovaného účtu Spustit jako.

Parametry

-Agent

Určuje jeden nebo více spravovaných objektů počítače se systémem UNIX nebo Linux. Informace o tom, jak získat spravovaný objekt počítače se systémem UNIX nebo Linux, zadejte Get-Help Get-SCXAgent.

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

-ComputerName

Určuje pole názvů počítačů. Rutina vytvoří dočasná připojení se skupinami pro správu pro tyto počítače. Můžete použít názvy netBIOS, IP adresy nebo plně kvalifikované názvy domén (FQDN). Pokud chcete zadat místní počítač, zadejte název počítače, localhost nebo tečku (.).

Služba System Center Data Access musí být v počítači aktivní. Pokud nezadáte počítač, rutina použije počítač pro aktuální připojení skupiny pro správu.

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

-Confirm

Před spuštěním rutiny zobrazí výzvu k potvrzení.

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

-Credential

Určuje uživatelský účet, pod kterým se spouští připojení skupiny pro správu. Zadejte objekt PSCredential , například objekt, který rutina Get-Credential vrátí pro tento parametr. Další informace o objektech přihlašovacích údajů zadejte Get-Help Get-Credential.

Pokud zadáte počítač v parametru ComputerName , použijte účet, který má přístup k danému počítači. Ve výchozím nastavení je to aktuální uživatel.

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

-SCSession

Určuje pole objektů připojení . K získání objektů Connection použijte rutinu Get-SCOMManagementGroupConnection .

Pokud tento parametr není zadaný, rutina používá aktivní trvalé připojení ke skupině pro správu. Pomocí parametru SCSession zadejte jiné trvalé připojení. Dočasné připojení ke skupině pro správu můžete vytvořit pomocí parametrů ComputerName a Credential . Další informace zobrazíte zadáním Get-Help about_OpsMgr_Connections.

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

-SshCredential

Určuje privilegovaný parametr SshCredential použitý k provádění akcí aktualizace agenta. Pokud tento parametr není zadaný, rutina se pokusí pro agenta použít účet Spustit jako definovaného agenta.

Informace o tom, jak získat objekt přihlašovacích údajů SSH, zadejte Get-Help Get-SCXSSHCredential.

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

-WhatIf

Zobrazuje, co by se stalo při spuštění rutiny. Rutina není spuštěna.

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

-WsManCredential

Určuje přihlašovací údaje používané pro komunikaci agenta s nízkou úrovní oprávnění prostřednictvím WSManu. Tato rutina používá tyto přihlašovací údaje k ověření dostupnosti agenta.

Zadejte uživatelské jméno, například User01 nebo zadejte objekt PSCredential , například jeden, který vrací rutina Get-Credential. Když zadáte uživatelské jméno, zobrazí se výzva k zadání hesla.

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

Výstupy

Microsoft.Unix.Computer[]

Tato rutina vrátí kolekci výsledků upgradu, přičemž každá představuje stav upgradu počítače. Každý výsledek musí obsahovat následující informace:

  • Název hostitele
  • Operační systémy
  • Stará verze agenta
  • Nová verze agenta
  • stav upgradu
  • Popis

Popis obsahuje podrobnosti o tom, proč se upgrade nezdařil.

Poznámky

  • Tato rutina přebírá kolekci názvů hostitelů výčtem. Shromažďuje všechny názvy hostitelů a zpracovává celou kolekci paralelně na konci kanálu.