Get-SCXAgent
Ruft eine Liste der verwalteten UNIX- und Linux-Computer in einer Verwaltungsgruppe ab.
Syntax
Empty (Standardwert)
Get-SCXAgent
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[<CommonParameters>]
FromAgentNamesParameterSetName
Get-SCXAgent
[-Name] <String[]>
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[<CommonParameters>]
FromAgentGuidsParameterSetName
Get-SCXAgent
-ID <Guid[]>
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[<CommonParameters>]
FromResourcePoolParameterSetName
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.
Parametereigenschaften
| Typ: | String[] |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | 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.
Parametereigenschaften
| Typ: | PSCredential |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | 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.
Parametereigenschaften
| Typ: | Guid[] |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
FromAgentGuidsParameterSetName
| Position: | Named |
| Obligatorisch.: | True |
| Wert aus Pipeline: | True |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | 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.
Parametereigenschaften
| Typ: | String[] |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
| Aliase: | Anzeigename |
Parametersätze
FromAgentNamesParameterSetName
| Position: | 1 |
| Obligatorisch.: | True |
| Wert aus Pipeline: | True |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | 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.
Parametereigenschaften
| Typ: | ManagementServicePool |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
| Aliase: | RP |
Parametersätze
FromResourcePoolParameterSetName
| Position: | Named |
| Obligatorisch.: | True |
| Wert aus Pipeline: | True |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | 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.
Parametereigenschaften
| Typ: | Connection[] |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
CommonParameters
Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.
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.