Delen via

Remove-SCXAgent

  • Referentie
Module:
OperationsManager

Hiermee verwijdert u de beoogde beheerde UNIX- en Linux-computers uit de beheergroep.

Syntaxis

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

Description

De cmdlet Remove-SCXAgent verwijdert de doel beheerde UNIX- en Linux-computers uit de beheergroep. Beheerde UNIX- en Linux-computers worden doorgegeven aan de cmdlet Remove-SCXAgent als een matrix van UNIX- en Linux-computerobjecten.

Zie de cmdlet Get-SCXAgent voor informatie over het ophalen van beheerde UNIX- en Linux-computers.

Deze cmdlet retourneert geen uitvoer.

Voorbeelden

Voorbeeld 1: Beheeragents verwijderen

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

De eerste opdracht haalt agents op voor beheerde Linux- of UNIX-computers die overeenkomen met de opgegeven namen met behulp van de Get-SCXAgent-cmdlet. Met de opdracht worden de resultaten opgeslagen in de $Agents matrixvariabele.

Met de laatste opdracht worden de agents in $Agents verwijderd.

Voorbeeld 2: Een beheeragent verwijderen met het gedefinieerde Uitvoeren als-account

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

Met deze opdracht worden agents voor beheerde Linux- of UNIX-computers ophaalt die overeenkomen met de opgegeven namen met behulp van Get-SCXAgent-. De opdracht geeft de agents door aan de huidige cmdlet. Met de opdracht worden de beheeragents verwijderd.

Parameters

-Agent

Hiermee geeft u een of meer beheerde UNIX- en Linux-computerobjecten op. Typ Get-Help Get-SCXAgentvoor informatie over het ophalen van een beheerd UNIX- of Linux-computerobject.

Type:IPersistedUnixComputer[]
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-ComputerName

Hiermee geeft u een matrix van namen van computers. Met de cmdlet worden tijdelijke verbindingen met beheergroepen voor deze computers tot stand gebracht. U kunt NetBIOS-namen, IP-adressen of FQDN's (Fully Qualified Domain Names) gebruiken. Als u de lokale computer wilt opgeven, typt u de computernaam, localhost of een punt (.).

De System Center Data Access-service moet actief zijn op de computer. Als u geen computer opgeeft, gebruikt de cmdlet de computer voor de huidige beheergroepverbinding.

Type:String[]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Confirm

U wordt gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type:SwitchParameter
Aliassen:cf
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Credential

Hiermee geeft u het gebruikersaccount waaronder de verbinding met de beheergroep wordt uitgevoerd. Geef een PSCredential--object op, zoals een object dat door de Get-Credential cmdlet wordt geretourneerd voor deze parameter. Typ Get-Help Get-Credentialvoor meer informatie over referentieobjecten.

Als u een computer opgeeft in de parameter ComputerName, gebruikt u een account dat toegang heeft tot die computer. De standaardwaarde is de huidige gebruiker.

Type:PSCredential
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-SCSession

Hiermee geeft u een matrix van Connection-objecten. Gebruik de cmdlet Get-SCOMManagementGroupConnection om Connection-objecten op te halen.

Als deze parameter niet is opgegeven, gebruikt de cmdlet de actieve permanente verbinding met een beheergroep. Gebruik de parameter SCSession om een andere permanente verbinding op te geven. U kunt een tijdelijke verbinding met een beheergroep maken met behulp van de parameters ComputerName en Credential. Typ Get-Help about_OpsMgr_Connectionsvoor meer informatie.

Type:Connection[]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-WhatIf

Toont wat er zou gebeuren als de cmdlet wordt uitgevoerd. De cmdlet wordt niet uitgevoerd.

Type:SwitchParameter
Aliassen:wi
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

Uitvoerwaarden

Met deze cmdlet wordt geen uitvoer gegenereerd. Er is geen foutcase voor de cmdlet Remove-SCXAgent.