Uninstall-SCXAgent
Odinstalowuje agenta zarządzania na określonych zarządzanych komputerach z systemami UNIX i Linux.
Składnia
Default (Domyślna)
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.
Właściwości parametru
| Typ: | IPersistedUnixComputer[] |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowy: | True |
| Wartość z potoku: | True |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | 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.
Właściwości parametru
| Typ: | String[] |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowy: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-Confirm
Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.
Właściwości parametru
| Typ: | SwitchParameter |
| Domyślna wartość: | False |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
| Aliasy: | por |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowy: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | 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.
Właściwości parametru
| Typ: | PSCredential |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowy: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-SCSession
Określa tablicę obiektów połączenia
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 Get-Help about_OpsMgr_Connections.
Właściwości parametru
| Typ: | Connection[] |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowy: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | 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.
Właściwości parametru
| Typ: | CredentialSet |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowy: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-WhatIf
Pokazuje, co się stanie, jeśli polecenie cmdlet zostanie uruchomione. Polecenie cmdlet nie jest uruchamiane.
Właściwości parametru
| Typ: | SwitchParameter |
| Domyślna wartość: | False |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
| Aliasy: | Wi |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowy: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
CommonParameters
To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.
Dane wyjściowe
undefined
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ę.