Freigeben über

Get-SCXAgent

  • Referenz
Modul:
OperationsManager

Ruft eine Liste der verwalteten UNIX- und Linux-Computer in einer Verwaltungsgruppe ab.

Syntax

Get-SCXAgent
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [<CommonParameters>]
Get-SCXAgent
   [-Name] <String[]>
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [<CommonParameters>]
Get-SCXAgent
   -ID <Guid[]>
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [<CommonParameters>]
Get-SCXAgent
   -ResourcePool <ManagementServicePool>
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [<CommonParameters>]

Beschreibung

Das cmdlet Get-SCXAgent ruft die verwalteten UNIX- und Linux-Computer ab, die den bereitgestellten Auswahlkriterien entsprechen. Wenn keine Auswahlkriterien angegeben werden, werden alle verwalteten UNIX- und Linux-Computer in der Verwaltungsgruppe zurückgegeben.

Ergebnisse werden als Array von verwalteten UNIX- und Linux-Computerobjekten zurückgegeben.

Beispiele

Beispiel 1: Zurückgeben verwalteter UNIX- und Linux-Computer

PS C:\>Get-SCXAgent

Dieser Befehl gibt alle verwalteten UNIX- und Linux-Computer im Ressourcenpool zurück.

Beispiel 2: Zurückgeben verwalteter UNIX- und Linux-Computer aus einem Ressourcenpool

PS C:\>$ResourcePool = Get-SCOMResourcePool -DisplayName "pool01"
PS C:\> Get-SCXAgent -ResourcePool $ResourcePool

Der erste Befehl ruft einen Ressourcenpool mithilfe des cmdlets Get-SCOMResourcePool ab und speichert ihn in der variablen $ResourcePool.

Der zweite Befehl gibt alle verwalteten UNIX- und Linux-Computer für den Ressourcenpool in $ResourcePool zurück.

Beispiel 3: Zurückgeben verwalteter UNIX- und Linux-Computer mithilfe des Namens

PS C:\>Get-SCXAgent -Name "nx1.contoso.com,nx2.*","*.development.contoso.com"

Dieser Befehl gibt verwaltete UNIX- und Linux-Computer mit Namen zurück, die einer bereitgestellten Liste von Zeichenfolgen entsprechen.

Beispiel 4: Zurückgeben verwalteter UNIX- und Linux-Computer mithilfe der Pipeline

PS C:\>"server1", "server2", "server3" | Get-SCXAgent

Dieser Befehl stellt den parameter Name über die Pipeline bereit.

Beispiel 5: Herstellen einer Verbindung mit einem Ressourcenpool und Abrufen eines verwalteten Computers anhand des Namens

PS C:\>Get-SCXAgent -Name "*development.contoso.com" -ComputerName "server1.contoso.com"

Dieser Befehl stellt eine Verbindung mit einem Ressourcenpool mit einer temporären Verbindung mithilfe der Anmeldeinformationen des aktuellen Benutzers und gibt nur die verwalteten Computer zurück, die dem Name Eigenschaft entsprechen.

Parameter

-ComputerName

Gibt ein Array von Namen von Computern an. Das Cmdlet richtet temporäre Verbindungen mit Verwaltungsgruppen für diese Computer ein. 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 aktiv sein. 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 das Benutzerkonto an, unter dem die Verwaltungsgruppenverbindung ausgeführt wird. Geben Sie für diesen Parameter ein PSCredential--Objekt an, z. B. ein Objekt, das vom Get-Credential--Cmdlet zurückgegeben wird. Wenn Sie weitere Informationen zu Anmeldeinformationsobjekten wünschen, geben Sie Get-Help Get-Credentialein.

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

-ID

Gibt die ID eines verwalteten UNIX- oder Linux-Computerobjekts an. Gibt nur die einzigen verwalteten Computer mit ID-Eigenschaften zurück, die diesem Wert entsprechen. Dieser Parameter wird von der Pipeline akzeptiert.

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

-Name

Gibt eine Liste der vollqualifizierten Domänennamen für einen oder mehrere verwaltete UNIX- und Linux-Computer an. Gibt nur die verwalteten Computer zurück, die der eigenschaft Name entsprechen.

Sie können Wildcards einschließen, in diesem Fall werden alle Computer zurückgegeben, die mit dem Wildcard übereinstimmen. Geben Sie Get-Help About_Wildcardsein, um Informationen zur Verwendung von Wildcards zu erfahren.

Dieser Parameter wird von der Pipeline akzeptiert.

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

-ResourcePool

Gibt einen Ressourcenpool von Servern an, von denen einer der aktuellen Verwaltungsserver und der andere als Sicherungsverwaltungsserver fungiert. Dieser Parameter erfordert ein Ressourcenpoolobjekt und gibt nur die verwalteten Computer in diesem Ressourcenpool zurück.

Um Informationen zum Abrufen eines SCOMResourcePool--Objekts zu erhalten, geben Sie Get-Help Get-SCOMResourcePoolein.

Typ:ManagementServicePool
Aliase:RP
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-SCSession

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

Wenn dieser Parameter nicht angegeben ist, verwendet das Cmdlet die aktive dauerhafte Verbindung zu einer Verwaltungsgruppe. Verwenden Sie den SCSession--Parameter, um eine andere dauerhafte Verbindung anzugeben. Sie können eine temporäre Verbindung mit einer Verwaltungsgruppe erstellen, indem Sie die Parameter ComputerName und Anmeldeinformationen verwenden. Geben Sie Get-Help about_OpsMgr_Connectionsein, um weitere Informationen zu erfahren.

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

Ausgaben

Microsoft.Unix.Computer[]

Dieses Cmdlet gibt ein oder mehrere Computerobjekte zurück, die verwaltete UNIX- und Linux-Computer darstellen, wenn die UNIX- und Linux-Computer Eingabekriterien erfüllen.