Get-SCOMAgent

Referenz

Modul:: OperationsManager

Ruft die verwalteten Agent-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 verwalteten Agent-Computer in einer Verwaltungsgruppe ab. Sie können den DNSHostName-Parameter angeben, um die verwalteten Agentcomputer auf einem DNS-Host (Domain Name System) abzurufen, oder Sie können den ManagementServer-Parameter angeben, um alle untergeordneten 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 namens MgmtServer01.Contoso.com ab und speichert das Objekt in der $MgmtServer Variablen.

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

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 ab, die server01.contoso.com genannt werden, die einen Namen haben, der mit Server02 beginnt und die sich in der Contoso.com Domäne befinden.

Beispiel 4: Abrufen aller Agents in einer Domäne

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

Dieser Befehl legt eine temporäre Verbindung mit dem Computer namens Server01.Contoso.com fest und ruft alle Agents in der Contoso.com Domäne ab.

Parameter

-ComputerName

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

-Credential

Gibt ein PSCredential-Objekt für die Verwaltungsgruppenverbindung an. Verwenden Sie zum Abrufen eines PSCredential-Objekts das Get-Credential-Cmdlet. Geben Sie Folgendes ein, um weitere Informationen zu erhalten: Get-Help Get-Credential.

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

-DNSHostName

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

Type:	String[]
Aliases:	Name
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-ManagementServer

Gibt ein ManagementServer-Objekt an. Dieser Parameter gibt den primären Verwaltungsserver an, aus dem alle untergeordneten Agents abgerufen werden sollen. Verwenden Sie zum Abrufen eines ManagementServer-Objekts das Cmdlet Get-SCOMManagementServer .

Type:	ManagementServer
Aliases:	MS
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-SCSession

Gibt ein Array von Connection-Objekten an. Verwenden Sie zum Abrufen eines Connection-Objekts das Cmdlet Get-SCOMManagementGroupConnection.

Ein Verbindungsobjekt stellt eine Verbindung mit einem Verwaltungsserver dar. Die Standardeinstellung ist die aktuelle Verwaltungsgruppenverbindung.

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

Ausgaben

Microsoft.EnterpriseManagement.Administration.AgentManagedComputer