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 Agent 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 do akcji aktualizacji uprzywilejowanego agenta, podczas gdy podany WsManCredential jest używany do komunikacji z agentem o niskim poziomie uprawnień. Jeśli nie podano parametru SshCredential, polecenie cmdlet próbuje użyć 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 drugich i trzecich poleceń.

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 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.

Typ:IPersistedUnixComputer[]
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych: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żywa komputera dla bieżącego połączenia grupy zarządzania.

Typ:String[]
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

Typ:SwitchParameter
Aliasy:cf
Position:Named
Domyślna wartość:False
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych: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 polecenia cmdlet Get-Credential zwracany 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 bieżący użytkownik.

Typ:PSCredential
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych: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 Get-Help about_OpsMgr_Connections.

Typ:Connection[]
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych: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.

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

Typ:CredentialSet
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-WhatIf

Pokazuje, co się stanie, jeśli polecenie cmdlet zostanie uruchomione. Polecenie cmdlet nie jest uruchamiane.

Typ:SwitchParameter
Aliasy:wi
Position:Named
Domyślna wartość:False
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-WsManCredential

Określa poświadczenia używane do komunikacji z agentem o niskim poziomie uprawnień za pośrednictwem programu 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 obiekt zwracany przez polecenie cmdlet Get-Credential. Podczas wpisywania nazwy użytkownika zostanie wyświetlony monit o podanie hasła.

Typ:PSCredential
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

Dane wyjściowe

Microsoft.Unix.Computer[]

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

  • 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 wyliczony. Zbiera wszystkie nazwy hostów i przetwarza całą kolekcję równolegle na końcu potoku.