Udostępnij za pośrednictwem

Update-SCXAgent

  • Odwołanie
Moduł:
OperationsManager

Uaktualnia agenta zarządzania na określonych komputerach z systemami UNIX i Linux do najnowszej dostępnej wersji.

Składnia

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

Opis

Polecenie cmdlet Update-SCXAgent aktualizuje agenta na określonych komputerach do najnowszej dostępnej wersji. Jeśli najnowsza dostępna wersja agenta zarządzania jest już zainstalowana na komputerze docelowym, nie zostanie podjęta żadna akcja.

Wymagany parametr agenta określa docelowe zarządzane komputery z systemami UNIX i Linux do odinstalowania i wymagają obiektu komputera z systemami UNIX i Linux. Aby uzyskać informacje na temat pobierania zarządzanych komputerów z systemami UNIX i Linux, zobacz polecenie cmdlet Get-SCXAgent. To polecenie cmdlet akceptuje parametry wejściowe SshCredential i WsManCredential . Podany parametr SshCredential jest używany dla uprzywilejowanych akcji aktualizacji agenta, podczas gdy podany element WsManCredential jest używany do komunikacji z agentem o niskich uprawnieniach. Jeśli parametr SshCredential nie zostanie podany, polecenie cmdlet podejmie próbę użycia zdefiniowanego konta Uruchom jako agenta skojarzonego z komputerem docelowym.

Dane wyjściowe tego polecenia cmdlet to tablica zarządzanych obiektów komputerów z systemem UNIX lub Linux reprezentujących systemy docelowe, które zostały pomyślnie zaktualizowane.

Przykłady

Przykład 1. Aktualizowanie agenta zarządzania

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

Pierwsze polecenie pobiera agenta zarządzanego komputera z systemem Linux lub UNIX o nazwie nx1.contoso.com przy użyciu polecenia cmdlet Get-SCXAgent. Polecenie przechowuje je w zmiennej $Agent 01.

Drugie polecenie pobiera poświadczenia dla użytkownika przy użyciu polecenia cmdlet Get-Credential. Polecenie wyświetla monit o uwierzytelnienie, a następnie zapisuje wyniki w zmiennej $WSCredential.

Trzecie polecenie tworzy uprzywilejowane poświadczenie dla użytkownika przy użyciu polecenia cmdlet Get-SCXSSHCredential. Polecenie przechowuje wynik w zmiennej $SSHCredential.

Ostatnie polecenie aktualizuje agenta zarządzania w $Agent 01 wartościami z drugiego i trzeciego polecenia.

Przykład 2. Aktualizowanie agenta zarządzania przy użyciu zdefiniowanego konta Uruchom jako

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

To polecenie pobiera agenta zarządzanego komputera z systemem Linux lub UNIX o nazwie nx1.contoso.com przy użyciu polecenia Get-SCXAgent. Polecenie przekazuje zarządzany komputer do bieżącego polecenia cmdlet. Polecenie aktualizuje agenta zarządzania przy użyciu zdefiniowanego konta Uruchom jako.

Parametry

-Agent

Określa co najmniej jeden zarządzany obiekt komputera z systemem UNIX lub Linux. Aby uzyskać informacje o sposobie uzyskiwania zarządzanego obiektu komputera z systemem UNIX lub Linux, wpisz Get-Help Get-SCXAgent.

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

-ComputerName

Określa tablicę nazw komputerów. Polecenie cmdlet ustanawia tymczasowe połączenia z grupami zarządzania dla tych komputerów. Można użyć nazw NetBIOS, adresów IP lub w pełni kwalifikowanych nazw domen (FQDN). Aby określić komputer lokalny, wpisz nazwę komputera, localhost lub kropkę (.).

Usługa System Center Data Access musi być aktywna na komputerze. Jeśli komputer nie zostanie określony, polecenie cmdlet użyje komputera dla bieżącego połączenia grupy zarządzania.

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

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

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

-Credential

Określa konto użytkownika, w ramach którego jest uruchamiane połączenie grupy zarządzania. Określ obiekt PSCredential , taki jak obiekt zwracany przez polecenie cmdlet Get-Credential dla tego parametru. Aby uzyskać więcej informacji na temat obiektów poświadczeń, wpisz Get-Help Get-Credential.

Jeśli określisz komputer w parametrze ComputerName , użyj konta, które ma dostęp do tego komputera. Wartość domyślna to użytkownik bieżący.

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

-SCSession

Określa tablicę obiektów Połączenia . Aby uzyskać obiekty Połączenia , użyj polecenia cmdlet Get-SCOMManagementGroupConnection .

Jeśli ten parametr nie zostanie określony, polecenie cmdlet używa aktywnego trwałego połączenia z grupą zarządzania. Użyj parametru SCSession , aby określić inne trwałe połączenie. Możesz utworzyć tymczasowe połączenie z grupą zarządzania przy użyciu parametrów ComputerName i Credential . Aby uzyskać więcej informacji, wpisz polecenie Get-Help about_OpsMgr_Connections.

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

-SshCredential

Określa uprzywilejowany parametr SshCredential używany do wykonywania akcji aktualizacji agenta. Jeśli ten parametr nie zostanie określony, polecenie cmdlet podejmie próbę użycia zdefiniowanego konta Uruchom jako agenta dla agenta.

Aby uzyskać informacje o sposobie uzyskiwania obiektu poświadczeń SSH, wpisz Get-Help Get-SCXSSHCredential.

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

-WhatIf

Pokazuje, co się stanie po uruchomieniu polecenia cmdlet. Polecenie cmdlet nie zostało uruchomione.

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

-WsManCredential

Określa poświadczenia używane do komunikacji agenta o niskim poziomie uprawnień za pośrednictwem narzędzia WSMan. To polecenie cmdlet używa tego poświadczenia do weryfikowania dostępności agenta.

Wpisz nazwę użytkownika, taką jak User01 lub wprowadź obiekt PSCredential , taki jak zwracany przez polecenie cmdlet Get-Credential. Podczas wpisywania nazwy użytkownika zostanie wyświetlony monit o podanie hasła.

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

Dane wyjściowe

Microsoft.Unix.Computer[]

To polecenie cmdlet zwraca kolekcję wyników uaktualniania, z których każdy reprezentuje stan uaktualnienia komputera. Każdy wynik musi zawierać następujące informacje:

  • Hostname (Nazwa hosta)
  • Systemy operacyjne
  • Stara wersja agenta
  • Nowa wersja agenta
  • stan uaktualnienia
  • Opis

Opis zawiera szczegółowe informacje o tym, dlaczego uaktualnienie nie powiodło się.

Uwagi

  • To polecenie cmdlet przyjmuje kolekcję nazw hostów w sposób wyliczany. Zbiera ona wszystkie nazwy hostów i przetwarza całą kolekcję równolegle na końcu potoku.