Freigeben über

Remove-SCXAgent

  • Referenz
Modul:
OperationsManager

Entfernt die gezielt verwalteten UNIX- und Linux-Computer aus der Verwaltungsgruppe.

Syntax

Remove-SCXAgent
      -Agent <IPersistedUnixComputer[]>
      [-SCSession <Connection[]>]
      [-ComputerName <String[]>]
      [-Credential <PSCredential>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Beschreibung

Das Cmdlet Remove-SCXAgent entfernt die zielverwalteten UNIX- und Linux-Computer aus der Verwaltungsgruppe. Verwaltete UNIX- und Linux-Computer werden als Array von UNIX- und Linux-Computerobjekten an das Cmdlet Remove-SCXAgent übergeben.

Informationen zum Abrufen verwalteter UNIX- und Linux-Computer finden Sie im cmdlet Get-SCXAgent.

Dieses Cmdlet gibt keine Ausgabe zurück.

Beispiele

Beispiel 1: Entfernen von Verwaltungs-Agents

PS C:\>$Agents = Get-SCXAgent -Name "scxserver1.contoso.com","scxserver2*","*.development.contoso.com"
PS C:\> Remove-SCXAgent -Agent $Agents

Der erste Befehl ruft Agents für verwaltete Linux- oder UNIX-Computer ab, die den angegebenen Namen mithilfe des Cmdlets Get-SCXAgent entsprechen. Der Befehl speichert die Ergebnisse in der $Agents Arrayvariable.

Der letzte Befehl entfernt die Agents in $Agents.

Beispiel 2: Deinstallieren eines Verwaltungs-Agents mit dem definierten Konto "Ausführen als"

PS C:\>Get-SCXAgent -Name "scxserver1.contoso.com","scxserver2*","*.development.contoso.com" | Remove-SCXAgent

Dieser Befehl ruft Agents für verwaltete Linux- oder UNIX-Computer ab, die den angegebenen Namen mithilfe von Get-SCXAgententsprechen. Der Befehl übergibt die Agents an das aktuelle Cmdlet. Mit dem Befehl werden die Verwaltungs-Agents entfernt.

Parameter

-Agent

Gibt mindestens ein verwaltetes UNIX- und Linux-Computerobjekt an. Um Informationen zum Abrufen eines verwalteten UNIX- oder Linux-Computerobjekts zu erhalten, geben Sie Get-Help Get-SCXAgentein.

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

-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

-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

Ausgaben

Dieses Cmdlet generiert keine Ausgabe. Fehlerfall für das Cmdlet Remove-SCXAgent.