Partager via

Get-SCXAgent

  • Référence
Module:
OperationsManager

Obtient une liste d’ordinateurs UNIX et Linux managés dans un groupe d’administration.

Syntaxe

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

L’applet de commande Get-SCXAgent Get-SCXAgent récupère les ordinateurs UNIX et Linux gérés qui correspondent aux critères de sélection fournis. Si aucun critère de sélection n’est spécifié, tous les ordinateurs UNIX et Linux managés du groupe d’administration sont retournés.

Les résultats sont retournés sous la forme d’un tableau d’objets d’ordinateur UNIX et Linux managés.

Exemples

Exemple 1 : Retourner des ordinateurs UNIX et Linux managés

PS C:\>Get-SCXAgent

Cette commande retourne tous les ordinateurs UNIX et Linux managés dans le pool de ressources.

Exemple 2 : Retourner des ordinateurs UNIX et Linux managés à partir d’un pool de ressources

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

La première commande obtient un pool de ressources à l’aide de l’applet de commande Get-SCOMResourcePool et la stocke dans la variable $ResourcePool.

La deuxième commande retourne tous les ordinateurs UNIX et Linux managés pour le pool de ressources dans $ResourcePool.

Exemple 3 : Retourner des ordinateurs UNIX et Linux gérés à l’aide du nom

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

Cette commande retourne des ordinateurs UNIX et Linux managés avec des noms qui correspondent à une liste fournie de chaînes.

Exemple 4 : Retourner des ordinateurs UNIX et Linux managés à l’aide du pipeline

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

Cette commande fournit le paramètre Name via le pipeline.

Exemple 5 : Se connecter à un pool de ressources et obtenir un ordinateur géré par nom

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

Cette commande se connecte à un pool de ressources avec une connexion temporaire, à l’aide des informations d’identification de l’utilisateur actuel et retourne uniquement les ordinateurs gérés qui correspondent à la propriété Name.

Paramètres

-ComputerName

Spécifie un tableau de noms d’ordinateurs. L’applet de commande établit des connexions temporaires avec des groupes d’administration pour ces ordinateurs. Vous pouvez utiliser des noms NetBIOS, des adresses IP ou des noms de domaine complets (FQDN). Pour spécifier l’ordinateur local, tapez le nom de l’ordinateur, localhost ou un point (.).

Le service System Center Data Access doit être actif sur l’ordinateur. Si vous ne spécifiez pas d’ordinateur, l’applet de commande utilise l’ordinateur pour la connexion de groupe d’administration actuelle.

Type:String[]
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Credential

Spécifie le compte d’utilisateur sous lequel la connexion au groupe d’administration s’exécute. Spécifiez un objet PSCredential, tel que celui retourné par l’applet de commande Get-Credential Get-Credential, pour ce paramètre. Pour plus d’informations sur les objets d’informations d’identification, tapez Get-Help Get-Credential.

Si vous spécifiez un ordinateur dans le paramètre ComputerName, utilisez un compte qui a accès à cet ordinateur. La valeur par défaut est l’utilisateur actuel.

Type:PSCredential
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ID

Spécifie l’ID d’un objet ordinateur UNIX ou Linux managé. Retourne uniquement les seuls ordinateurs gérés avec des propriétés d’ID qui correspondent à cette valeur. Ce paramètre est accepté à partir du pipeline.

Type:Guid[]
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-Name

Spécifie une liste de noms de domaine complets pour un ou plusieurs ordinateurs UNIX et Linux managés. Renvoie uniquement les ordinateurs gérés qui correspondent à la propriété Name.

Vous pouvez inclure des caractères génériques, auquel cas tous les ordinateurs correspondant au caractère générique sont retournés. Pour plus d’informations sur l’utilisation de caractères génériques, tapez Get-Help About_Wildcards.

Ce paramètre est accepté à partir du pipeline.

Type:String[]
Alias:DisplayName
Position:1
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-ResourcePool

Spécifie un pool de ressources de serveurs, dont l’un est affecté comme serveur d’administration actuel et l’autre servant de serveurs d’administration de sauvegarde. Ce paramètre nécessite un objet de pool de ressources et retourne uniquement les ordinateurs gérés de ce pool de ressources.

Pour plus d’informations sur l’obtention d’un objet SCOMResourcePool, tapez Get-Help Get-SCOMResourcePool.

Type:ManagementServicePool
Alias:RP
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-SCSession

Spécifie un tableau d’objets Connection. Pour obtenir objets Connection, utilisez l’applet de commande Get-SCOMManagementGroupConnection .

Si ce paramètre n’est pas spécifié, l’applet de commande utilise la connexion persistante active à un groupe d’administration. Utilisez le paramètre SCSession pour spécifier une connexion persistante différente. Vous pouvez créer une connexion temporaire à un groupe d’administration à l’aide des paramètres ComputerName et Credential. Pour plus d’informations, tapez Get-Help about_OpsMgr_Connections.

Type:Connection[]
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

Sorties

Microsoft.Unix.Computer[]

Cette applet de commande retourne un ou plusieurs objets ordinateurs qui représentent des ordinateurs UNIX et Linux gérés lorsque les ordinateurs UNIX et Linux correspondent aux critères d’entrée.