Remove-SCAdvisorAgent

Referenz

Modul:: OperationsManager

Entfernt einen oder mehrere Agents aus der Gruppe von 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 nach Namen 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 Folgendes ein, um weitere Informationen zu erhalten: Get-Help Where-Object.

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 nach Namen 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 mithilfe des Pipelineoperators get-SCOMClassInstance an Get-SCOMClassInstance zu übergeben, um Computer062 zu finden, und verwendet dann Where-Object , um Agents zu finden, die den Namen ContosoAgent enthalten. Der Befehl speichert diese Instanzen in der variablen $WindowsComputers.

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

Parameter

-ComputerName

Gibt ein Array von Namen von Computern an. Das Cmdlet stellt temporäre Verbindungen mit Verwaltungsgruppen für diese Computer her. Sie können NetBIOS-Namen, IP-Adressen oder vollqualifizierte Domänennamen (FQDNs) verwenden. Um den lokalen Computer anzugeben, geben Sie den Computernamen, 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.

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Credential

Gibt das Benutzerkonto an, unter dem die Verwaltungsgruppenverbindung ausgeführt wird. Geben Sie ein PSCredential-Objekt an, z. B. eins, das das Cmdlet Get-Credential zurückgibt, für diesen Parameter. Geben Sie weitere Informationen zu Anmeldeinformationenobjekten ein Get-Help Get-Credential.

Wenn Sie einen Computer im ComputerName-Parameter angeben, verwenden Sie ein Konto, das Zugriff auf diesen Computer hat. Der Standardwert ist der aktuelle Benutzer.

Type:	PSCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-InputObjects

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

Type:	PartialMonitoringObject[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-SCSession

Gibt ein Array von Connection-Objekten an. Verwenden Sie zum Abrufen von Connection-Objekten 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 mithilfe der Parameter "ComputerName " und "Anmeldeinformationen " erstellen. Geben Sie Folgendes ein, um weitere Informationen zu erhalten: Get-Help about_OpsMgr_Connections.

Type:	Connection[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

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

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False