Get-SCOMAgent
Obtient les ordinateurs gérés par l’agent dans un groupe d’administration.
Syntaxe
Empty (Par défaut)
Get-SCOMAgent
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[<CommonParameters>]
FromManagementServer
Get-SCOMAgent
[-ManagementServer] <ManagementServer>
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[<CommonParameters>]
FromAgentNames
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.
Propriétés du paramètre
| Type: | String[] |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Credential
Spécifie un objet PSCredential pour la connexion de groupe d’administration.
Pour obtenir un objet 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.
Propriétés du paramètre
| Type: | PSCredential |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-DNSHostName
Spécifie le nom d’un hôte DNS (Domain Name System) de l’ordinateur géré par l’agent.
Propriétés du paramètre
| Type: | String[] |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
| Alias: | Nom |
Jeux de paramètres
FromAgentNames
| Position: | 1 |
| Obligatoire: | True |
| Valeur du pipeline: | True |
| Valeur du pipeline par nom de propriété: | True |
| Valeur des arguments restants: | 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
Propriétés du paramètre
| Type: | ManagementServer |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
| Alias: | MS |
Jeux de paramètres
FromManagementServer
| Position: | 1 |
| Obligatoire: | True |
| Valeur du pipeline: | True |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-SCSession
Spécifie un tableau d’objets Connection.
Pour obtenir un objet
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.
Propriétés du paramètre
| Type: | Connection[] |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
CommonParameters
Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.