Get-SCOMAlert
Obtient les alertes Operations Manager.
Syntaxe
Empty (Par défaut)
Get-SCOMAlert
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[<CommonParameters>]
FromAlertId
Get-SCOMAlert
[-Id] <Guid[]>
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[<CommonParameters>]
FromAlertDefault
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>]
FromCriteria
Get-SCOMAlert
[[-Criteria] <String>]
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[<CommonParameters>]
Description
La cmdlet 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 moniteurs peuvent générer des alertes.
Exemples
Exemple 1 : Obtenir toutes les nouvelles alertes
PS C:\>Get-SCOMAlert -ResolutionState 0
Cette commande obtient toutes les alertes qui ont un état de résolution é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 d’é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 une valeur de TestServer dans la propriété CustomField1.
Exemple 4 : Obtenir les 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 d’heure retournée par LastModified est au format UTC, tandis que Get-Date est de l’heure système locale.
Exemple 5 : Obtenir des alertes et supprimer des 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 = $OriginalErrorAction
Cet 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 correspondantes continuent à s’exécuter et n’affichent pas d’erreur.
La troisième commande obtient toutes les classes avec un état d’intégrité dans leur nom et transmet les objets de classe à l'Get-SCOMClassInstance applet de commande à l’aide de l’opérateur de pipeline. La Get-SCOMClassInstance obtient les instances de classe pour chaque objet de classe et transmet chacun des objets d’instance de classe à l’applet de commande Get-SCOMAlert. La cmdlet Get-SCOMAlert retourne les alertes dont l’état de résolution est compris entre 5 et 200, inclus, pour chaque instance de classe.
La quatrième commande définit la valeur de la variable $ErrorActionPreference sur 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-dac9ff76dabd
Cette 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 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 |
-Criteria
Spécifie le code XML des critères qui indique comment filtrer les alertes. Les critères peuvent filtrer sur des règles ou des analyses particulières, ou 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
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
FromCriteria
| Position: | 10 |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-HealthState
Spécifie un tableau d’états d’intégrité. Les valeurs valides sont les suivantes : critique (rouge), avertissement (jaune), sain (vert).
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
FromAlertDefault
| Position: | 7 |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | 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».
Propriétés du paramètre
| Type: | Guid[] |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
FromAlertId
| Position: | 1 |
| Obligatoire: | True |
| Valeur du pipeline: | True |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Instance
Spécifie un tableau d’objets d’instance de classe.
Ce paramètre accepte également les objets de groupe.
Pour obtenir un objet d’instance de classe, utilisez l’applet de commande Get-SCOMClassInstance Get-Help Get-SCOMClassInstance.
Propriétés du paramètre
| Type: | EnterpriseManagementObject[] |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
FromAlertDefault
| Position: | 1 |
| Obligatoire: | False |
| Valeur du pipeline: | True |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-LastModifiedBy
Spécifie un tableau de noms d’utilisateurs. 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.
Propriétés du paramètre
| Type: | String[] |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | True |
| DontShow: | False |
Jeux de paramètres
FromAlertDefault
| Position: | 2 |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-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.
Propriétés du paramètre
| Type: | String[] |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | True |
| DontShow: | False |
Jeux de paramètres
FromAlertDefault
| Position: | 3 |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Owner
Spécifie un tableau de noms d’utilisateurs. L’applet de commande obtient une alerte si le propriétaire d’une alerte correspond à un nom d’utilisateur que vous spécifiez.
Propriétés du paramètre
| Type: | String[] |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | True |
| DontShow: | False |
Jeux de paramètres
FromAlertDefault
| Position: | 4 |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Priority
Spécifie un tableau de niveaux de prioirty d’alerte. Les valeurs valides sont les suivantes :
- Bas
- Douleur moyenne
- Haut
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
FromAlertDefault
| Position: | 8 |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-ResolutionState
Spécifie un tableau d’ID d’état de résolution.
Lorsqu’une alerte est générée, son état de résolution est Nouveau. Les opérateurs peuvent modifier l’état de résolution d’une nouvelle alerte sur Fermé ou sur un état de résolution personnalisé créé par un administrateur pour le groupe d’administration. L’ID du nouveau est 0 et l’ID pour Fermé est 255. Vous pouvez affecter des états de résolution personnalisés à n’importe quelle valeur comprise entre 2 et 254.
Propriétés du paramètre
| Type: | Int32[] |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | True |
| DontShow: | False |
Jeux de paramètres
FromAlertDefault
| Position: | 5 |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-ResolvedBy
Spécifie un tableau de noms d’utilisateurs. 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.
Propriétés du paramètre
| Type: | String[] |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | True |
| DontShow: | False |
Jeux de paramètres
FromAlertDefault
| Position: | 6 |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| 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 |
-Severity
Spécifie un tableau de valeurs de gravité d’alertes. Les valeurs valides sont les suivantes :
- Information
- Avertissement
- Critique
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
FromAlertDefault
| Position: | 9 |
| 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.