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 soddisfano i 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 nome 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 Di accesso ai dati di System Center deve essere attivo nel computer. Se non si specifica un computer, il cmdlet usa il computer per la connessione al gruppo di gestione corrente.

Tipo:String[]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly: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, utilizzare un account che abbia accesso a tale computer. Il valore predefinito è l'utente corrente.

Tipo:PSCredential
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ID

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

Tipo:Guid[]
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly: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à Nome .

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

Questo parametro viene accettato dalla pipeline.

Tipo:String[]
Alias:DisplayName
Posizione:1
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly: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 di 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 .

Tipo:ManagementServicePool
Alias:RP
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-SCSession

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

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

Tipo:Connection[]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly: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.