Partager via

Get-SCOMAgent

  • Référence
Module:
OperationsManager

Obtient les ordinateurs gérés par l’agent dans un groupe d’administration.

Syntaxe

Get-SCOMAgent
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [<CommonParameters>]
Get-SCOMAgent
   [-ManagementServer] <ManagementServer>
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [<CommonParameters>]
Get-SCOMAgent
   [-DNSHostName] <String[]>
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [<CommonParameters>]

Description

La cmdlet Get-SCOMAgent obtient les ordinateurs gérés par l’agent dans un groupe d’administration. Vous pouvez spécifier le paramètre DNSHostName pour obtenir les ordinateurs gérés par l’agent sur un hôte DNS (Domain Name System), ou vous pouvez spécifier le paramètre ManagementServer pour obtenir tous les ordinateurs gérés par l’agent enfant pour un serveur d’administration principal.

Exemples

Exemple 1 : Obtenir tous les agents dans le groupe d’administration

PS C:\>Get-SCOMAgent -ComputerName "Server01.Contoso.Com"

Cette commande établit une connexion temporaire avec l’ordinateur nommé Server01 et obtient tous les agents du groupe d’administration.

Exemple 2 : Obtenir les agents gérés par un serveur d’administration

PS C:\>$MgmtServer = Get-SCOMManagementServer "MgmtServer01.Contoso.com"
PS C:\> Get-SCOMAgent -ManagementServer $MgmtServer

Cet exemple obtient des ordinateurs gérés par un agent gérés par un serveur d’administration.

La première commande obtient l’objet serveur d’administration nommé MgmtServer01.Contoso.com et stocke l’objet dans la variable $MgmtServer.

La deuxième commande obtient les agents gérés par le serveur d’administration stocké dans $MgmtServer.

Exemple 3 : Obtenir des agents dans un groupe d’administration à l’aide du nom de l’agent

PS C:\>Get-SCOMAgent -DNSHostName "server01.contoso.com", "Server02*", "*.Contoso.com"

Cette commande obtient les agents nommés server01.contoso.com, qui ont un nom commençant par Server02 et qui se trouvent dans le domaine Contoso.com.

Exemple 4 : Obtenir tous les agents dans un domaine

PS C:\>Get-SCOMAgent -DNSHostName "*.Contoso.com" -ComputerName "Server01.Contoso.com"

Cette commande établit une connexion temporaire avec l’ordinateur nommé Server01.Contoso.com et obtient tous les agents dans le domaine Contoso.com.

Paramètres

-ComputerName

Spécifie un tableau de noms d’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 s’exécuter 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 un objet PSCredential pour la connexion de groupe d’administration. Pour obtenir un objet PSCredential, utilisez l’applet de commande Get-Credential . Pour plus d’informations, 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

-DNSHostName

Spécifie le nom d’un hôte DNS (Domain Name System) de l’ordinateur géré par l’agent.

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

-ManagementServer

Spécifie un objet ManagementServer. Ce paramètre spécifie le serveur d’administration principal à partir duquel récupérer tous les agents enfants. Pour obtenir un objet ManagementServer, utilisez l’applet de commande Get-SCOMManagementServer .

Type:ManagementServer
Alias:MS
Position:1
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 un objet Connection, utilisez l’applet de commande Get-SCOMManagementGroupConnection .

Un objet de connexion représente une connexion à un serveur d’administration. La valeur par défaut est la connexion de groupe d’administration actuelle.

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.EnterpriseManagement.Administration.AgentManagedComputer