Get-SCOMAlert
Obtient des alertes Operations Manager.
Syntaxe
Get-SCOMAlert
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[<CommonParameters>]Get-SCOMAlert
[-Id] <Guid[]>
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[<CommonParameters>]Get-SCOMAlert
[[-Instance] <EnterpriseManagementObject[]>]
[[-LastModifiedBy] <String[]>]
[[-Name] <String[]>]
[[-Owner] <String[]>]
[[-ResolutionState] <Int32[]>]
[[-ResolvedBy] <String[]>]
[[-HealthState] <String[]>]
[[-Priority] <String[]>]
[[-Severity] <String[]>]
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[<CommonParameters>]Get-SCOMAlert
[[-Criteria] <String>]
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[<CommonParameters>]Description
L’applet de commande Get-SCOMAlert obtient une ou plusieurs alertes. Une alerte est une indication d’un événement important qui nécessite votre attention. Les règles et les analyses peuvent générer des alertes.
Exemples
Exemple 1 : Obtenir toutes les nouvelles alertes
PS C:\>Get-SCOMAlert -ResolutionState 0Cette commande obtient toutes les alertes dont l’état de résolution est égal à zéro (nouvelles alertes).
Exemple 2 : Obtenir toutes les alertes non fermées
PS C:\>Get-SCOMAlert -Criteria "ResolutionState != 255 and Severity != 0"Cette commande obtient toutes les alertes qui n’ont pas un état de résolution de 255 (alertes fermées) et la gravité n’est pas informationnelle.
Exemple 3 : Obtenir des alertes à l’aide d’un champ personnalisé
PS C:\>Get-SCOMAlert -Criteria "CustomField1 = 'TestServer'"Cette commande obtient toutes les alertes qui ont la valeur TestServer dans la propriété CustomField1 .
Exemple 4 : Obtenir des alertes modifiées au cours des 30 dernières minutes
PS C:\>Get-SCOMAlert -Criteria "LastModified > '$((Get-Date).AddMinutes(-30))'"Cette commande obtient toutes les alertes qui ont été modifiées au cours des 30 dernières minutes. La valeur de temps retournée par LastModified est en UTC, tandis que Get-Date est de l’heure système locale.
Exemple 5 : Obtenir des alertes et supprimer les messages d’erreur
PS C:\>$OriginalErrorAction = $ErrorActionPreference
PS C:\> $ErrorActionPreference = "SilentlyContinue"
PS C:\> Get-SCOMClass -Name "*health*" | Get-SCOMClassInstance | Get-SCOMAlert -ResolutionState (5..200)
PS C:\> $ErrorActionPreference = $OriginalErrorActionCet exemple obtient des alertes et supprime les messages d’erreur pour les instances de classe qui ne correspondent pas aux critères de la commande.
La première commande stocke la valeur de la variable $ErrorActionPreference dans la variable $OriginalErrorAction.
La deuxième commande définit la valeur de la variable $ErrorActionPreference sur SilentlyContinue. En définissant la valeur de la variable $ErrorActionPreference sur SilentlyContinue, les instances de classe qui n’ont pas de résultats de tâche correspondants continuent à s’exécuter et n’affichent pas d’erreur.
La troisième commande obtient toutes les classes avec l’intégrité dans leur nom et transmet les objets de classe à l’applet de commande Get-SCOMClassInstance à l’aide de l’opérateur de pipeline. Get-SCOMClassInstance obtient les instances de classe pour chaque objet de classe et transmet chacun de la classe instance objets à l’applet de commande Get-SCOMAlert. L’applet de commande Get-SCOMAlert retourne les alertes dont l’état de résolution est compris entre 5 et 200, inclus, pour chaque classe instance.
La quatrième commande rétablit la valeur de la variable $ErrorActionPreference à la valeur stockée dans la variable $OriginalErrorAction.
Exemple 6 : Obtenir une alerte à l’aide de l’ID
PS C:\>Get-SCOMAlert -Id 7413b06b-a95b-4ae3-98f2-dac9ff76dabdCette commande obtient l’alerte qui a l’ID 7413b06b-a95b-4ae3-98f2-dac9ff76dabd.
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 être en cours d’exécution sur l’ordinateur. Si vous ne spécifiez pas d’ordinateur, l’applet de commande utilise l’ordinateur pour la connexion actuelle au groupe d’administration.
| 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 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 |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-Criteria
Spécifie les critères XML qui indiquent comment filtrer les alertes. Les critères peuvent filtrer sur des règles ou des analyses particulières, ou sur des propriétés de l’alerte, mais ne peuvent pas filtrer sur des classes ou des groupes. Vous trouverez plus d’informations ici : https://learn.microsoft.com/previous-versions/system-center/developer/bb437603(v=msdn.10)?redirectedfrom=MSDN
| Type: | String |
| Position: | 10 |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-HealthState
Spécifie un tableau d’états d’intégrité. Les valeurs valides sont les suivantes : critique (rouge), avertissement (jaune), sain (vert).
| Type: | String[] |
| Position: | 7 |
| 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 un tableau de GUID d’objets d’alerte.
Pour obtenir l’ID d’une alerte, tapez «Get-SCOMAlert | Format-Table Name, Id ».
| Type: | Guid[] |
| Position: | 1 |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | True |
| Accepter les caractères génériques: | False |
-Instance
Spécifie un tableau d’objets de classe instance.
Ce paramètre accepte également les objets de groupe.
Pour obtenir une classe instance objet, utilisez l’applet de commande Get-SCOMClassInstance.
Pour plus d'informations, voir Get-Help Get-SCOMClassInstance.
| Type: | EnterpriseManagementObject[] |
| Position: | 1 |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | True |
| Accepter les caractères génériques: | False |
-LastModifiedBy
Spécifie un tableau de noms d’utilisateur. L’applet de commande obtient les alertes si le dernier utilisateur qui a modifié l’alerte correspond à un nom d’utilisateur que vous spécifiez.
| Type: | String[] |
| Position: | 2 |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | True |
-Name
Spécifie un tableau de noms d’alerte. L’applet de commande obtient les alertes qui correspondent aux noms d’alerte que vous spécifiez.
| Type: | String[] |
| Position: | 3 |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | True |
-Owner
Spécifie un tableau de noms d’utilisateur. L’applet de commande obtient une alerte si le propriétaire d’une alerte correspond à un nom d’utilisateur que vous spécifiez.
| Type: | String[] |
| Position: | 4 |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | True |
-Priority
Spécifie un tableau de niveaux de priorité d’alerte. Les valeurs autorisées sont :
- Faible
- Moyenne
- Élevé
| Type: | String[] |
| Position: | 8 |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-ResolutionState
Spécifie un tableau d’ID d’état de résolution.
Quand une alerte est générée, son état de résolution est Nouveau. Les opérateurs peuvent faire passer l’état de résolution d’une nouvelle alerte à l’état Fermé ou bien à un état de résolution personnalisé qu’un administrateur a créé pour le groupe d’administration. L’ID de New est 0 et l’ID pour Closed est 255. Vous pouvez affecter des états de résolution personnalisés n’importe quelle valeur comprise entre 2 et 254.
| Type: | Int32[] |
| Position: | 5 |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | True |
-ResolvedBy
Spécifie un tableau de noms d’utilisateur. L’applet de commande obtient les alertes si l’utilisateur qui a résolu l’alerte correspond à un nom d’utilisateur que vous spécifiez.
| Type: | String[] |
| Position: | 6 |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | True |
-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 |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-Severity
Spécifie un tableau de valeurs de gravité des alertes. Les valeurs autorisées sont :
- Information
- Avertissement
- Critique
| Type: | String[] |
| Position: | 9 |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |