Partager via

Get-SCXAgent

  • Référence
Module:
OperationsManager

Obtient la liste des ordinateurs UNIX et Linux gérés dans un groupe d’administration.

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

L’applet de commande 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 géré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 gérés.

Exemples

Exemple 1 : Retourner des ordinateurs UNIX et Linux gérés

PS C:\>Get-SCXAgent

Cette commande retourne tous les ordinateurs UNIX et Linux géré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 gérés avec des noms qui correspondent à une liste fournie de chaînes.

Exemple 4 : Retourner des ordinateurs UNIX et Linux géré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 managé 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
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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 , 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
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ID

Spécifie l’ID d’un objet d’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
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Name

Spécifie une liste de noms de domaine complets pour un ou plusieurs ordinateurs UNIX et Linux gérés. Retourne 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[]
Aliases:DisplayName
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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 dans ce pool de ressources.

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

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

-SCSession

Spécifie un tableau d’objets Connection . Pour obtenir des 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 autre connexion persistante. Vous pouvez créer une connexion temporaire à un groupe d’administration à l’aide des paramètres ComputerName et Credential . Pour plus d'informations, voir Get-Help about_OpsMgr_Connections.

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

Sorties

Microsoft.Unix.Computer[]

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