Freigeben über

Get-SCOMAgent

  • Referenz
Modul:
OperationsManager

Ruft die vom Agent verwalteten Computer in einer Verwaltungsgruppe ab.

Syntax

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>]

Beschreibung

Das Cmdlet Get-SCOMAgent ruft die vom Agent verwalteten Computer in einer Verwaltungsgruppe ab. Sie können den parameter DNSHostName angeben, um die vom Agent verwalteten Computer auf einem DNS-Host (Domain Name System) abzurufen, oder Sie können den Parameter ManagementServer angeben, um alle vom Agent verwalteten Computer für einen primären Verwaltungsserver abzurufen.

Beispiele

Beispiel 1: Abrufen aller Agents in der Verwaltungsgruppe

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

Dieser Befehl stellt eine temporäre Verbindung mit dem Computer mit dem Namen Server01 her und ruft alle Agents in der Verwaltungsgruppe ab.

Beispiel 2: Abrufen der von einem Verwaltungsserver verwalteten Agents

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

In diesem Beispiel werden vom Agent verwaltete Computer abgerufen, die von einem Verwaltungsserver verwaltet werden.

Der erste Befehl ruft das Verwaltungsserverobjekt mit dem Namen MgmtServer01.Contoso.com ab und speichert das Objekt in der variablen $MgmtServer.

Der zweite Befehl ruft die Agents ab, die vom in $MgmtServer gespeicherten Verwaltungsserver verwaltet werden.

Beispiel 3: Abrufen von Agents in einer Verwaltungsgruppe mithilfe des Agentnamens

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

Dieser Befehl ruft Agents mit dem Namen server01.contoso.com ab, die einen Namen haben, der mit Server02 beginnt und sich in der domäne Contoso.com befinden.

Beispiel 4: Abrufen aller Agents in einer Domäne

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

Dieser Befehl stellt eine temporäre Verbindung mit dem Computer namens Server01.Contoso.com her und ruft alle Agents in der domäne Contoso.com ab.

Parameter

-ComputerName

Gibt ein Array von Namen von Computern an. 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 ausgeführt werden. 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

-Credential

Gibt ein PSCredential- -Objekt für die Verwaltungsgruppenverbindung an. Um ein PSCredential-Objekt abzurufen, verwenden Sie das Cmdlet Get-Credential. Geben Sie Get-Help Get-Credentialein, um weitere Informationen zu erfahren.

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

-DNSHostName

Gibt den Namen eines DNS-Hosts (Domain Name System) des vom Agent verwalteten Computers an.

Typ:String[]
Aliase:Name
Position:1
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-ManagementServer

Gibt ein ManagementServer- -Objekt an. Dieser Parameter gibt den primären Verwaltungsserver an, von dem alle untergeordneten Agents abgerufen werden sollen. Um ein ManagementServer--Objekt abzurufen, verwenden Sie das cmdlet Get-SCOMManagementServer.

Typ:ManagementServer
Aliase:MS
Position:1
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-SCSession

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

Ein Verbindungsobjekt stellt eine Verbindung mit einem Verwaltungsserver dar. Der Standardwert ist die aktuelle Verwaltungsgruppenverbindung.

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

Ausgaben

Microsoft.EnterpriseManagement.Administration.AgentManagedComputer