Condividi tramite

Get-SCXAgent

  • Riferimento
Modulo:
OperationsManager

Ottiene un elenco di computer UNIX e Linux gestiti in un gruppo di gestione.

Sintassi

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

Descrizione

Il cmdlet Get-SCXAgent recupera i computer UNIX e Linux gestiti che corrispondono ai criteri di selezione specificati. Se non vengono specificati criteri di selezione, vengono restituiti tutti i computer UNIX e Linux gestiti nel gruppo di gestione.

I risultati vengono restituiti come matrice di oggetti computer UNIX e Linux gestiti.

Esempio

Esempio 1: Restituire computer UNIX e Linux gestiti

PS C:\>Get-SCXAgent

Questo comando restituisce tutti i computer UNIX e Linux gestiti nel pool di risorse.

Esempio 2: Restituire computer UNIX e Linux gestiti da un pool di risorse

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

Il primo comando ottiene un pool di risorse usando il cmdlet Get-SCOMResourcePool e lo archivia nella variabile $ResourcePool.

Il secondo comando restituisce tutti i computer UNIX e Linux gestiti per il pool di risorse in $ResourcePool.

Esempio 3: Restituire computer UNIX e Linux gestiti usando il nome

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

Questo comando restituisce computer UNIX e Linux gestiti con nomi corrispondenti a un elenco specificato di stringhe.

Esempio 4: Restituire computer UNIX e Linux gestiti usando la pipeline

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

Questo comando fornisce il parametro Name tramite la pipeline.

Esempio 5: Connettersi a un pool di risorse e ottenere un computer gestito in base al nome

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

Questo comando si connette a un pool di risorse con una connessione temporanea, usando le credenziali dell'utente corrente e restituisce solo i computer gestiti che corrispondono alla proprietà Name .

Parametri

-ComputerName

Specifica una matrice di nomi di computer. Il cmdlet stabilisce connessioni temporanee con i gruppi di gestione per questi computer. È possibile usare nomi NetBIOS, indirizzi IP o nomi di dominio completi (FQDN). Per specificare il computer locale, digitare il nome del computer, localhost o un punto (.).

Il servizio System Center Data Access deve essere attivo nel computer. Se non si specifica un computer, il cmdlet usa il computer per la connessione del gruppo di gestione corrente.

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

-Credential

Specifica l'account utente in cui viene eseguita la connessione al gruppo di gestione. Specificare un oggetto PSCredential , ad esempio quello restituito dal cmdlet Get-Credential , per questo parametro. Per altre informazioni sugli oggetti credenziali, digitare Get-Help Get-Credential.

Se si specifica un computer nel parametro ComputerName , usare un account che ha accesso a tale computer. Il valore predefinito è l'utente corrente.

Type:PSCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ID

Specifica l'ID di un oggetto computer UNIX o Linux gestito. Restituisce solo gli unici computer gestiti con proprietà ID corrispondenti a questo valore. Questo parametro viene accettato dalla pipeline.

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

-Name

Specifica un elenco di nomi di dominio completi per uno o più computer UNIX e Linux gestiti. Restituisce solo i computer gestiti che corrispondono alla proprietà Name .

È possibile includere caratteri jolly, nel qual caso vengono restituiti tutti i computer corrispondenti al carattere jolly. Per informazioni sull'uso di caratteri jolly, digitare Get-Help About_Wildcards.

Questo parametro viene accettato dalla pipeline.

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

-ResourcePool

Specifica un pool di risorse di server, uno dei quali viene assegnato come server di gestione corrente e l'altro che funge da server di gestione del backup. Questo parametro richiede un oggetto pool di risorse e restituisce solo i computer gestiti in tale pool di risorse.

Per informazioni su come ottenere un oggetto SCOMResourcePool , digitare Get-Help Get-SCOMResourcePool.

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

-SCSession

Specifica una matrice di oggetti Connection . Per ottenere oggetti Connection , usare il cmdlet Get-SCOMManagementGroupConnection .

Se questo parametro non è specificato, il cmdlet usa la connessione persistente attiva a un gruppo di gestione. Usare il parametro SCSession per specificare una connessione persistente diversa. È possibile creare una connessione temporanea a un gruppo di gestione usando i parametri ComputerName e Credential . Per ulteriori informazioni, digitare Get-Help about_OpsMgr_Connections.

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

Output

Microsoft.Unix.Computer[]

Questo cmdlet restituisce uno o più oggetti Computer che rappresentano computer UNIX e Linux gestiti quando i computer UNIX e Linux corrispondono ai criteri di input.