Partager via

Get-SCOMAgent

  • Référence
Module:
OperationsManager

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

Syntax

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

L’applet de commande 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
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Credential

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

-DNSHostName

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

Type:String[]
Aliases:Name
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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
Aliases:MS
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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 actuelle au groupe d'administration.

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

Sorties

Microsoft.EnterpriseManagement.Administration.AgentManagedComputer