Freigeben über

Remove-SCAdvisorAgent

  • Referenz
Modul:
OperationsManager

Entfernt einen oder mehrere Agents aus der Gruppe der Agents, die dem Advisor Connector melden.

Syntax

Remove-SCAdvisorAgent
      [-InputObjects <PartialMonitoringObject[]>]
      [-SCSession <Connection[]>]
      [-ComputerName <String[]>]
      [-Credential <PSCredential>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Beschreibung

Das Cmdlet Remove-SCAdvisorAgent entfernt einen oder mehrere Agents aus der Gruppe der Agents, die dem System Center Advisor Connector melden.

Beispiele

Beispiel 1: Entfernen von Agents anhand eines Namens aus einer Gruppe von Computern

PS C:\> $WindowsComputers = Get-SCClass -Name "Microsoft.Windows.computer" | Get-SCOMClassInstance | Where {$_.Name.Contains("ContosoAgent")}
PS C:\> Remove-SCAdvisorAgent -InputObjects $WindowsComputers

Der erste Befehl verwendet das Cmdlet Get-SCClass zum Abrufen aller Windows-basierten Computer, übergibt diese Computer mithilfe des Pipelineoperators an das cmdlet Get-SCOMClassInstance und verwendet dann das Cmdlet Where-Object, um Computer zu finden, die den Namen ContosoAgent enthalten. Der Befehl speichert diese Instanzen in der variablen $WindowsComputers. Geben Sie Get-Help Where-Objectein, um weitere Informationen zu erfahren.

Der zweite Befehl entfernt alle Agents, die in $WindowsComputers gespeichert sind, aus der Gruppe der Agents, die dem Advisor Connector melden.

Beispiel 2: Entfernen von Agents anhand eines Namens von einem Computer

PS C:\> $WindowsComputers = Get-SCClass -Name "Microsoft.Windows.computer" | Get-SCOMClassInstance -ComputerName "Computer062" | Where {$_.Name.Contains("ContosoAgent")}
PS C:\> Remove-SCAdvisorAgent -InputObjects $WindowsComputers -ComputerName "Computer062"

Der erste Befehl verwendet Get-SCClass, um alle Windows-basierten Computer abzurufen, diese Computer an Get-SCOMClassInstance- zu übergeben, indem der Pipelineoperator Computer062 verwendet und dann Where-Object- verwendet, um Agents zu finden, die den Namen "ContosoAgent" enthalten. Der Befehl speichert diese Instanzen in der variablen $WindowsComputers.

Mit dem zweiten Befehl werden alle Windows-basierten Computer, die in $WindowsComputers gespeichert sind, aus der Gruppe der Agents entfernt, die dem Advisor Connector melden.

Parameter

-ComputerName

Gibt ein Array von Namen von Computern an. Das Cmdlet richtet temporäre Verbindungen mit Verwaltungsgruppen für diese Computer ein. Sie können NetBIOS-Namen, IP-Adressen oder vollqualifizierte Domänennamen (FQDNs) verwenden. Um den lokalen Computer anzugeben, geben Sie den Computernamen, den Localhost oder einen Punkt (.) ein.

Der System Center Data Access-Dienst muss auf dem Computer aktiv sein. Wenn Sie keinen Computer angeben, verwendet das Cmdlet den Computer für die aktuelle Verwaltungsgruppenverbindung.

Typ:String[]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Confirm

Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.

Typ:SwitchParameter
Aliase:cf
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Credential

Gibt das Benutzerkonto an, unter dem die Verwaltungsgruppenverbindung ausgeführt wird. Geben Sie für diesen Parameter ein PSCredential--Objekt an, z. B. ein Objekt, das vom Get-Credential--Cmdlet zurückgegeben wird. Wenn Sie weitere Informationen zu Anmeldeinformationsobjekten wünschen, geben Sie Get-Help Get-Credentialein.

Wenn Sie einen Computer im parameter ComputerName angeben, verwenden Sie ein Konto, das Zugriff auf diesen Computer hat. Die Standardeinstellung ist der aktuelle Benutzer.

Typ:PSCredential
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-InputObjects

Gibt ein Array von Computernamen an, das vom Advisor Connector abgemeldet werden soll.

Typ:PartialMonitoringObject[]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-SCSession

Gibt ein Array von Connection -Objekten an. Um Connection-Objekte abzurufen, verwenden Sie das Cmdlet Get-SCOMManagementGroupConnection.

Wenn dieser Parameter nicht angegeben ist, verwendet das Cmdlet die aktive dauerhafte Verbindung zu einer Verwaltungsgruppe. Verwenden Sie den SCSession--Parameter, um eine andere dauerhafte Verbindung anzugeben. Sie können eine temporäre Verbindung mit einer Verwaltungsgruppe erstellen, indem Sie die Parameter ComputerName und Anmeldeinformationen verwenden. Geben Sie Get-Help about_OpsMgr_Connectionsein, um weitere Informationen zu erfahren.

Typ:Connection[]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-WhatIf

Zeigt, was passiert, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Typ:SwitchParameter
Aliase:wi
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False