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 Active Directory Domain Services (AD DS) z grupy zarządzania. Aby usunąć przypisania agenta usług AD DS z grupy zarządzania, możesz użyć polecenia Remove-SCOMADAgentAssignment cmdet.

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 przy użyciu 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

Ten przykład odinstalowuje agenta programu Operations Manager 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 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 wdrożenia. 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 polecenie Get-Help Get-Credential.

Type:PSCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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 .

Type:AgentManagedComputer[]
Position:Named
Default value:None
Required:True
Accept pipeline input:True
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

-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 żadnego wyniku.

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

Microsoft.EnterpriseManagement.Administration.AgentManagedComputer

Dane wyjściowe

Microsoft.EnterpriseManagement.Administration.AgentTaskResult