Partager via

Get-SCOMAlert

  • Référence
Module:
OperationsManager

Obtient les 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

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.

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

-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

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 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 . Pour plus d’informations, tapez 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’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.

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’utilisateurs. 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 prioirty d’alerte. Les valeurs valides sont les suivantes :

  • Bas
  • Douleur moyenne
  • Haut
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.

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.

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’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.

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 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

-Severity

Spécifie un tableau de valeurs de gravité d’alertes. Les valeurs valides sont les suivantes :

  • 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