Freigeben über

Get-SCXAgent

  • Referenz
Modul:
OperationsManager

Ruft eine Liste verwalteter 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 angegebenen Auswahlkriterien entsprechen. Wenn keine Auswahlkriterien angegeben werden, werden alle verwalteten UNIX- und Linux-Computer in der Verwaltungsgruppe zurückgegeben.

Ergebnisse werden als Array verwalteter UNIX- und Linux-Computerobjekte 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 $ResourcePool Variablen.

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 angegebenen 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 nach Name

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

Dieser Befehl verbindet sich mit einem Ressourcenpool mit einer temporären Verbindung mit den Anmeldeinformationen des aktuellen Benutzers und gibt nur die verwalteten Computer zurück, die der Name-Eigenschaft entsprechen.

Parameter

-ComputerName

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

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

-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 aus der Pipeline akzeptiert.

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

-Name

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

Sie können Wildcards einschließen, in diesem Fall werden alle Computer, die dem Wildcard entsprechen, zurückgegeben. Geben Sie Get-Help About_WildcardsInformationen zur Verwendung von Wildcards ein.

Dieser Parameter wird aus der Pipeline akzeptiert.

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

-ResourcePool

Gibt einen Ressourcenpool von Servern an, einer davon wird dem aktuellen Verwaltungsserver und dem anderen zugewiesen, der als Sicherungsverwaltungsserver dient. Dieser Parameter erfordert ein Ressourcenpoolobjekt und gibt nur die verwalteten Computer in diesem Ressourcenpool zurück.

Informationen zum Abrufen eines SCOMResourcePool-Objekts finden Sie unter Get-Help Get-SCOMResourcePool".

Type:ManagementServicePool
Aliases:RP
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-SCSession

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

Wenn dieser Parameter nicht angegeben wird, verwendet das Cmdlet die aktive persistente Verbindung zu einer Verwaltungsgruppe. Verwenden Sie den SCSession-Parameter , um eine andere persistente Verbindung anzugeben. Sie können eine temporäre Verbindung zu einer Verwaltungsgruppe erstellen, indem Sie die Parameter "ComputerName " und "Anmeldeinformationen " verwenden. Geben Sie Folgendes ein, um weitere Informationen zu erhalten: Get-Help about_OpsMgr_Connections.

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

Ausgaben

Microsoft.Unix.Computer[]

Dieses Cmdlet gibt mindestens ein Computerobjekt zurück, das verwaltete UNIX- und Linux-Computer darstellt, wenn die UNIX- und Linux-Computer eingabekriterien entsprechen.