Dela via

Get-SCXAgent

  • Referens
Modul:
OperationsManager

Hämtar en lista över hanterade UNIX- och Linux-datorer i en hanteringsgrupp.

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

Description

Cmdleten Get-SCXAgent hämtar de hanterade UNIX- och Linux-datorerna som matchar de angivna urvalskriterierna. Om inga urvalsvillkor anges returneras alla hanterade UNIX- och Linux-datorer i hanteringsgruppen.

Resultaten returneras som en matris med hanterade UNIX- och Linux-datorobjekt.

Exempel

Exempel 1: Returnera hanterade UNIX- och Linux-datorer

PS C:\>Get-SCXAgent

Det här kommandot returnerar alla hanterade UNIX- och Linux-datorer i resurspoolen.

Exempel 2: Returnera hanterade UNIX- och Linux-datorer från en resurspool

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

Det första kommandot hämtar en resurspool med hjälp av cmdleten Get-SCOMResourcePool och lagrar den i variabeln $ResourcePool.

Det andra kommandot returnerar alla hanterade UNIX- och Linux-datorer för resurspoolen i $ResourcePool.

Exempel 3: Returnera hanterade UNIX- och Linux-datorer med hjälp av namnet

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

Det här kommandot returnerar hanterade UNIX- och Linux-datorer med namn som matchar en lista med strängar.

Exempel 4: Returnera hanterade UNIX- och Linux-datorer med hjälp av pipelinen

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

Det här kommandot innehåller parametern Name via pipelinen.

Exempel 5: Anslut till en resurspool och hämta en hanterad dator efter namn

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

Det här kommandot ansluter till en resurspool med en tillfällig anslutning med hjälp av den aktuella användarens autentiseringsuppgifter och returnerar endast de hanterade datorer som matchar egenskapen Name.

Parametrar

-ComputerName

Anger en matris med namn på datorer. Cmdleten upprättar tillfälliga anslutningar med hanteringsgrupper för dessa datorer. Du kan använda NetBIOS-namn, IP-adresser eller fullständigt kvalificerade domännamn (FQDN). Om du vill ange den lokala datorn skriver du datornamnet, localhost eller en punkt (.).

System Center Data Access-tjänsten måste vara aktiv på datorn. Om du inte anger någon dator använder cmdleten datorn för den aktuella hanteringsgruppens anslutning.

Typ:String[]
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Credential

Anger det användarkonto under vilket anslutningen till hanteringsgruppen körs. Ange ett PSCredential- objekt, till exempel ett objekt som cmdleten Get-Credential returnerar för den här parametern. Om du vill ha mer information om autentiseringsobjekt skriver du Get-Help Get-Credential.

Om du anger en dator i parametern ComputerName använder du ett konto som har åtkomst till datorn. Standardvärdet är den aktuella användaren.

Typ:PSCredential
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-ID

Anger ID för ett hanterat UNIX- eller Linux-datorobjekt. Returnerar endast de enda hanterade datorerna med ID-egenskaper som matchar det här värdet. Den här parametern accepteras från pipelinen.

Typ:Guid[]
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-Name

Anger en lista över fullständigt kvalificerade domännamn för en eller flera hanterade UNIX- och Linux-datorer. Returnerar endast de hanterade datorer som matchar egenskapen Name.

Du kan inkludera jokertecken, i vilket fall alla datorer som matchar jokertecknet returneras. Om du vill ha information om hur du använder jokertecken skriver du Get-Help About_Wildcards.

Den här parametern accepteras från pipelinen.

Typ:String[]
Alias:DisplayName
Position:1
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-ResourcePool

Anger en resurspool med servrar, varav en är tilldelad till den aktuella hanteringsservern och den andra som fungerar som servrar för säkerhetskopieringshantering. Den här parametern kräver ett resurspoolobjekt och returnerar endast de hanterade datorerna i resurspoolen.

Om du vill ha information om hur du hämtar ett SCOMResourcePool--objekt skriver du Get-Help Get-SCOMResourcePool.

Typ:ManagementServicePool
Alias:RP
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-SCSession

Anger en matris med Anslutning objekt. Om du vill hämta anslutningsobjekt använder du cmdleten Get-SCOMManagementGroupConnection.

Om den här parametern inte anges använder cmdleten den aktiva beständiga anslutningen till en hanteringsgrupp. Använd parametern SCSession för att ange en annan beständig anslutning. Du kan skapa en tillfällig anslutning till en hanteringsgrupp med hjälp av parametrarna ComputerName och Credential. Om du vill ha mer information skriver du Get-Help about_OpsMgr_Connections.

Typ:Connection[]
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

Utdata

Microsoft.Unix.Computer[]

Den här cmdleten returnerar ett eller flera datorobjekt som representerar hanterade UNIX- och Linux-datorer när UNIX- och Linux-datorerna matchar indatavillkoren.