Delen via

Remove-SCAdvisorAgent

  • Referentie
Module:
OperationsManager

Hiermee verwijdert u een of meer agents uit de groep agents die rapporteren aan de Advisor Connector.

Syntaxis

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

Description

De cmdlet Remove-SCAdvisorAgent verwijdert een of meer agents uit de groep agents die rapporteren aan de System Center Advisor-connector.

Voorbeelden

Voorbeeld 1: Agents op naam verwijderen van een groep computers

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

De eerste opdracht maakt gebruik van de Get-SCClass cmdlet om alle Windows-computers op te halen, deze computers door te geven aan de Get-SCOMClassInstance cmdlet met behulp van de pijplijnoperator en gebruikt vervolgens de Where-Object cmdlet om computers te zoeken die de naam ContosoAgent bevatten. Met de opdracht worden deze exemplaren opgeslagen in de variabele $WindowsComputers. Typ Get-Help Where-Objectvoor meer informatie.

Met de tweede opdracht verwijdert u alle agents die zijn opgeslagen in $WindowsComputers uit de groep agents die rapporteren aan de Advisor Connector.

Voorbeeld 2: Agents op naam van een computer verwijderen

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"

De eerste opdracht gebruikt Get-SCClass om alle Windows-computers op te halen, geeft deze computers door aan Get-SCOMClassInstance met behulp van de pijplijnoperator om Computer062 te vinden en gebruikt vervolgens Where-Object om agents te vinden die de naam ContosoAgent bevatten. Met de opdracht worden deze exemplaren opgeslagen in de variabele $WindowsComputers.

Met de tweede opdracht worden alle Windows-computers verwijderd die zijn opgeslagen in $WindowsComputers uit de groep agents die rapporteren aan de Advisor Connector.

Parameters

-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

-InputObjects

Hiermee geeft u een matrix van computernamen op die u wilt afmelden bij de Advisor Connector.

Type:PartialMonitoringObject[]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
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