Udostępnij za pośrednictwem

Uninstall-SCXAgent

  • Odwołanie
Moduł:
OperationsManager

Odinstalowuje agenta zarządzania na określonych zarządzanych komputerach z systemami UNIX i Linux.

Składnia

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

Opis

Polecenie cmdlet Uninstall-SCXAgent odinstalowuje agenta zarządzania na określonych komputerach z systemami UNIX i Linux.

Wymagany parametr Agent określa docelowe zarządzane komputery z systemem UNIX lub Linux do odinstalowania i wymagają obiektu komputera z systemem UNIX lub Linux. Aby uzyskać informacje na temat pobierania zarządzanych komputerów z systemem UNIX lub Linux, zobacz polecenie cmdlet Get-SCXAgent. Opcjonalny parametr SSHCredential można określić w celu zidentyfikowania poświadczeń uprzywilejowanych używanych do odinstalowywania agenta zarządzania. Jeśli nie określono SSHCredential, polecenie cmdlet próbuje użyć zdefiniowanego uprzywilejowanego konta Uruchom jako dla agenta.

To polecenie cmdlet nie zwraca żadnych danych wyjściowych.

Przykłady

Przykład 1. Odinstalowywanie agenta zarządzania

PS C:\>$Agent01 = Get-SCXAgent -Name "nx1.contoso.com"
PS C:\> $SSHCredential = Get-SCXSSHCredential -UserName "DavidChew" -Key "C:\keys\key21.ppk" -ElevationType sudo
PS C:\> Uninstall-SCXAgent -SSHCredential $SSHCredential -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 tworzy uprzywilejowane poświadczenie dla użytkownika przy użyciu polecenia cmdlet Get-SCXSSHCredential. Polecenie przechowuje wynik w zmiennej $SSHCredential.

Ostatnie polecenie odinstalowuje agenta zarządzania w $Agent 01 przy użyciu określonego poświadczenia SSH.

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

PS C:\>Get-SCXAgent -Name "nx1.contoso.com" | Uninstall-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 odinstalowuje 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 uprzywilejowane poświadczenia SSH używane do wykonywania akcji konserwacji 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

Dane wyjściowe

To polecenie cmdlet zwraca wyniki reprezentujące stan odinstalowania komputera. Wyniki zawierają następujące informacje:

  • Nazwa hosta
  • Stan odinstalowania
  • Opis

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