Delen via

Get-SCOMAgent

  • Referentie
Module:
OperationsManager

Haalt de door agents beheerde computers op in een beheergroep.

Syntaxis

Get-SCOMAgent
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [<CommonParameters>]
Get-SCOMAgent
   [-ManagementServer] <ManagementServer>
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [<CommonParameters>]
Get-SCOMAgent
   [-DNSHostName] <String[]>
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [<CommonParameters>]

Description

De cmdlet Get-SCOMAgent haalt de door agents beheerde computers op in een beheergroep. U kunt de parameter DNSHostName opgeven om de door agents beheerde computers op een DNS-host (Domain Name System) op te halen. U kunt ook de parameter ManagementServer opgeven om alle onderliggende door agents beheerde computers op te halen voor een primaire beheerserver.

Voorbeelden

Voorbeeld 1: Alle agents in de beheergroep ophalen

PS C:\>Get-SCOMAgent -ComputerName "Server01.Contoso.Com"

Met deze opdracht wordt een tijdelijke verbinding tot stand gebracht met de computer met de naam Server01 en worden alle agents in de beheergroep ophaalt.

Voorbeeld 2: de agents ophalen die worden beheerd door een beheerserver

PS C:\>$MgmtServer = Get-SCOMManagementServer "MgmtServer01.Contoso.com"
PS C:\> Get-SCOMAgent -ManagementServer $MgmtServer

In dit voorbeeld worden door agents beheerde computers ophaalt die worden beheerd door een beheerserver.

Met de eerste opdracht wordt het beheerserverobject met de naam MgmtServer01.Contoso.com opgehaald en wordt het object opgeslagen in de variabele $MgmtServer.

De tweede opdracht haalt de agents op die worden beheerd door de beheerserver die is opgeslagen in $MgmtServer.

Voorbeeld 3: Agents in een beheergroep ophalen met behulp van de naam van de agent

PS C:\>Get-SCOMAgent -DNSHostName "server01.contoso.com", "Server02*", "*.Contoso.com"

Met deze opdracht worden agents met de naam server01.contoso.com, die een naam hebben die begint met Server02 en die zich in het Contoso.com domein bevinden.

Voorbeeld 4: Alle agents in een domein ophalen

PS C:\>Get-SCOMAgent -DNSHostName "*.Contoso.com" -ComputerName "Server01.Contoso.com"

Met deze opdracht wordt een tijdelijke verbinding tot stand gebracht met de computer met de naam Server01.Contoso.com en worden alle agents in het Contoso.com domein ophaalt.

Parameters

-ComputerName

Hiermee geeft u een matrix van namen van computers. 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 worden uitgevoerd 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

-Credential

Hiermee geeft u een PSCredential-object voor de verbinding met de beheergroep. Als u een PSCredential--object wilt verkrijgen, gebruikt u de cmdlet Get-Credential. Typ Get-Help Get-Credentialvoor meer informatie.

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

-DNSHostName

Hiermee geeft u de naam van een DNS-host (Domain Name System) van de door de agent beheerde computer.

Type:String[]
Aliassen:Name
Position:1
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-ManagementServer

Hiermee geeft u een ManagementServer-object. Met deze parameter geeft u de primaire beheerserver op waaruit alle onderliggende agents moeten worden opgehaald. Als u een ManagementServer--object wilt verkrijgen, gebruikt u de cmdlet Get-SCOMManagementServer.

Type:ManagementServer
Aliassen:MS
Position:1
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-SCSession

Hiermee geeft u een matrix van Connection-objecten. Als u een Connection-object wilt verkrijgen, gebruikt u de cmdlet Get-SCOMManagementGroupConnection.

Een verbindingsobject vertegenwoordigt een verbinding met een beheerserver. De standaardwaarde is de huidige verbinding met de beheergroep.

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

Uitvoerwaarden

Microsoft.EnterpriseManagement.Administration.AgentManagedComputer