Delen via

Get-SCXAgent

  • Referentie
Module:
OperationsManager

Hiermee haalt u een lijst op met beheerde UNIX- en Linux-computers in een beheergroep.

Syntaxis

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

Description

De cmdlet Get-SCXAgent haalt de beheerde UNIX- en Linux-computers op die voldoen aan de opgegeven selectiecriteria. Als er geen selectiecriteria zijn opgegeven, worden alle beheerde UNIX- en Linux-computers in de beheergroep geretourneerd.

Resultaten worden geretourneerd als een matrix van beheerde UNIX- en Linux-computerobjecten.

Voorbeelden

Voorbeeld 1: beheerde UNIX- en Linux-computers retourneren

PS C:\>Get-SCXAgent

Met deze opdracht worden alle beheerde UNIX- en Linux-computers in de resourcegroep geretourneerd.

Voorbeeld 2: beheerde UNIX- en Linux-computers retourneren uit een resourcegroep

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

De eerste opdracht haalt een resourcegroep op met behulp van de Get-SCOMResourcePool cmdlet en slaat deze op in de $ResourcePool variabele.

De tweede opdracht retourneert alle beheerde UNIX- en Linux-computers voor de resourcegroep in $ResourcePool.

Voorbeeld 3: beheerde UNIX- en Linux-computers retourneren met behulp van de naam

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

Met deze opdracht worden beheerde UNIX- en Linux-computers geretourneerd met namen die overeenkomen met een opgegeven lijst met tekenreeksen.

Voorbeeld 4: beheerde UNIX- en Linux-computers retourneren met behulp van de pijplijn

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

Met deze opdracht wordt de parameter Name via de pijplijn opgegeven.

Voorbeeld 5: Verbinding maken met een resourcegroep en een beheerde computer op naam ophalen

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

Met deze opdracht wordt verbinding gemaakt met een resourcegroep met een tijdelijke verbinding, met behulp van de referenties van de huidige gebruiker en worden alleen de beheerde computers geretourneerd die overeenkomen met de eigenschap Naam.

Parameters

-ComputerName

Hiermee geeft u een matrix van namen van computers. Met de cmdlet worden tijdelijke verbindingen met beheergroepen voor deze computers tot stand gebracht. U kunt NetBIOS-namen, IP-adressen of FQDN's (Fully Qualified Domain Names) gebruiken. Als u de lokale computer wilt opgeven, typt u de computernaam, localhost of een punt (.).

De System Center Data Access-service moet actief zijn op de computer. Als u geen computer opgeeft, gebruikt de cmdlet de computer voor de huidige beheergroepverbinding.

Type:String[]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Credential

Hiermee geeft u het gebruikersaccount waaronder de verbinding met de beheergroep wordt uitgevoerd. Geef een PSCredential--object op, zoals een object dat door de Get-Credential cmdlet wordt geretourneerd voor deze parameter. Typ Get-Help Get-Credentialvoor meer informatie over referentieobjecten.

Als u een computer opgeeft in de parameter ComputerName, gebruikt u een account dat toegang heeft tot die computer. De standaardwaarde is de huidige gebruiker.

Type:PSCredential
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-ID

Hiermee geeft u de id van een beheerd UNIX- of Linux-computerobject. Retourneert alleen de enige beheerde computers met id-eigenschappen die overeenkomen met deze waarde. Deze parameter wordt geaccepteerd vanuit de pijplijn.

Type:Guid[]
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Name

Hiermee geeft u een lijst met volledig gekwalificeerde domeinnamen op voor een of meer beheerde UNIX- en Linux-computers. Retourneert alleen de beheerde computers die overeenkomen met de eigenschap Name.

U kunt jokertekens opnemen. In dat geval worden alle computers die overeenkomen met het jokerteken geretourneerd. Typ Get-Help About_Wildcardsvoor informatie over het gebruik van jokertekens.

Deze parameter wordt geaccepteerd vanuit de pijplijn.

Type:String[]
Aliassen:DisplayName
Position:1
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-ResourcePool

Hiermee geeft u een resourcegroep van servers op, waarvan een is toegewezen aan de huidige beheerserver en de andere als back-upbeheerservers. Voor deze parameter is een resourcegroepobject vereist en worden alleen de beheerde computers in die resourcegroep geretourneerd.

Typ Get-Help Get-SCOMResourcePoolvoor informatie over het ophalen van een SCOMResourcePool--object.

Type:ManagementServicePool
Aliassen:RP
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-SCSession

Hiermee geeft u een matrix van Connection-objecten. Gebruik de cmdlet Get-SCOMManagementGroupConnection om Connection-objecten op te halen.

Als deze parameter niet is opgegeven, gebruikt de cmdlet de actieve permanente verbinding met een beheergroep. Gebruik de parameter SCSession om een andere permanente verbinding op te geven. U kunt een tijdelijke verbinding met een beheergroep maken met behulp van de parameters ComputerName en Credential. Typ Get-Help about_OpsMgr_Connectionsvoor meer informatie.

Type:Connection[]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

Uitvoerwaarden

Microsoft.Unix.Computer[]

Deze cmdlet retourneert een of meer computerobjecten die beheerde UNIX- en Linux-computers vertegenwoordigen wanneer de UNIX- en Linux-computers voldoen aan invoercriteria.