Uninstall-SCOMAgent
Odinstalowuje agentów z komputerów zarządzanych przez agenta.
Składnia
Default (Domyślna)
Uninstall-SCOMAgent
[-ActionAccount <PSCredential>]
-Agent <AgentManagedComputer[]>
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Opis
Polecenie cmdlet Uninstall-SCOMAgent odinstalowuje agentów z komputerów zarządzanych przez agenta. Przed odinstalowaniem agenta należy usunąć przypisania agenta usług Active Directory Domain Services (AD DS) z grupy zarządzania. Możesz użyć Remove-SCOMADAgentAssignment cmdet, aby usunąć przypisania agenta usług AD DS z grupy zarządzania.
Przykłady
Przykład 1. Odinstalowywanie agenta
PS C:\>Get-SCOMAgent -DNSHostName "server01.contoso.com" | Uninstall-SCOMAgent
Pierwsze polecenie pobiera obiekt agenta programu Operations Manager o nazwie server01.contoso.com i przekazuje go do polecenia cmdlet Uninstall-SCOMAgent za pomocą operatora potoku. Drugie polecenie odinstalowuje agenta o nazwie server01.contoso.com.
Przykład 2. Odinstalowywanie agenta przy użyciu zmiennej obiektu
PS C:\>$Agent = Get-SCOMAgent -DNSHostName "server01.contoso.com"
PS C:\> Uninstall-SCOMAgent -Agent $Agent
W tym przykładzie agent programu Operations Manager zostanie odinstalowany na komputerze zarządzanym przez agenta.
Pierwsze polecenie pobiera obiekt komputera zarządzanego przez agenta o nazwie server01.contoso.com i przechowuje obiekt w zmiennej $Agent.
Drugie polecenie odinstalowuje agenta przechowywanego w $Agent.
Przykład 3. Odinstalowywanie agenta przy użyciu konta działania
PS C:\>$Agent = Get-SCOMAgent -DNSHostName "server01.contoso.com"
PS C:\> Uninstall-SCOMAgent -Agent $Agent -ActionAccount (Get-Credential)
W tym przykładzie agent programu Operations Manager zostanie odinstalowany na komputerze zarządzanym przez agenta po wprowadzeniu przez użytkownika poświadczeń, których program Operations Manager wymaga odinstalowania agenta.
Pierwsze polecenie pobiera obiekt agenta o nazwie server01.contoso.com i przechowuje obiekt w zmiennej $Agent.
Drugie polecenie wyświetla użytkownikowi monit o wprowadzenie poświadczeń używanych przez program Operations Manager do odinstalowania agenta. Następnie polecenie odinstalowuje agenta przechowywanego w $Agent.
Parametry
-ActionAccount
Określa obiekt PSCredential. Ten parametr określa poświadczenia używane przez program Operations Manager do uruchamiania zadania wdrażania. Jeśli nie określisz tego parametru lub określisz wartość null, program Operations Manager używa domyślnego konta działania serwera zarządzania dla agenta.
Aby uzyskać obiekt PSCredential, użyj polecenia cmdlet Get-Credential.
Aby uzyskać więcej informacji, wpisz Get-Help Get-Credential.
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 |
-Agent
Określa tablicę obiektów AgentManagedComputer. Ten parametr określa agentów programu Operations Manager do odinstalowania. Aby uzyskać obiekt AgentManagedComputer, użyj polecenia cmdlet Get-SCOMADAgent.
Właściwości parametru
| Typ: | AgentManagedComputer[] |
| 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 |
-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 |
-PassThru
Wskazuje, że polecenie cmdlet tworzy lub modyfikuje obiekt, którego polecenie może użyć w potoku. Domyślnie to polecenie cmdlet nie generuje żadnych danych wyjściowych.
Właściwości parametru
| Typ: | SwitchParameter |
| 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.