Udostępnij za pośrednictwem

Uninstall-SCOMAgent

  • Odwołanie
Moduł:
OperationsManager

Odinstalowuje agentów z komputerów zarządzanych przez agenta.

Składnia

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.

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

Typ:AgentManagedComputer[]
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
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

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

Typ:SwitchParameter
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 wejściowe

Microsoft.EnterpriseManagement.Administration.AgentManagedComputer

Dane wyjściowe

Microsoft.EnterpriseManagement.Administration.AgentTaskResult