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 agenta 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 ustawienia 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świadczenia 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 polecenia 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.

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

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