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 verwalteten UNIX- und Linux-Computer aus der Verwaltungsgruppe. Verwaltete UNIX- und Linux-Computer werden an das Cmdlet Remove-SCXAgent als Array von UNIX- und Linux-Computerobjekten ü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 entsprechen, indem sie das Cmdlet Get-SCXAgent verwenden. 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 Run As-Konto

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 mit Get-SCXAgent entsprechen. Der Befehl übergibt die Agents an das aktuelle Cmdlet. Der Befehl entfernt die Verwaltungs-Agents.

Parameter

-Agent

Gibt mindestens ein verwaltetes UNIX- und Linux-Computerobjekt an. Informationen zum Abrufen eines verwalteten UNIX- oder Linux-Computerobjekts finden Sie unter Get-Help Get-SCXAgent".

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

-ComputerName

Gibt ein Array von Namen von Computern an. Das Cmdlet erstellt temporäre Verbindungen mit Verwaltungsgruppen für diese Computer. Sie können NetBIOS-Namen, IP-Adressen oder vollqualifizierte Domänennamen (FQDNs) verwenden. Geben Sie zum Angeben des lokalen Computers 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 Get-Credential-Cmdlet zurückgibt, für diesen Parameter. Weitere Informationen zu Anmeldeinformationenobjekten geben Sie Get-Help Get-Credentialein.

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

-SCSession

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

Wenn dieser Parameter nicht angegeben wird, verwendet das Cmdlet die aktive persistente Verbindung zu einer Verwaltungsgruppe. Verwenden Sie den SCSession-Parameter , um eine andere persistente Verbindung anzugeben. Sie können eine temporäre Verbindung zu einer Verwaltungsgruppe erstellen, indem Sie die Parameter "ComputerName " und "Anmeldeinformationen " verwenden. 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

Ausgaben

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