Partager via

Get-SCOMAlert

  • Référence
Module:
OperationsManager

Obtient des alertes Operations Manager.

Syntax

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 0

Cette 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 = $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 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-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 ê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
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

-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
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:True

-Priority

Spécifie un tableau de niveaux de priorité d’alerte. Les valeurs autorisées sont :

  • Faible
  • Moyenne
  • Élevé
Type:String[]
Position:8
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Severity

Spécifie un tableau de valeurs de gravité des alertes. Les valeurs autorisées sont :

  • Information
  • Avertissement
  • Critique
Type:String[]
Position:9
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False