Partager via


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

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

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.