Freigeben über

Get-SCOMAlert

  • Referenz
Modul:
OperationsManager

Ruft Operations Manager-Warnungen ab.

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

Beschreibung

Das cmdlet Get-SCOMAlert ruft mindestens eine Warnung ab. Eine Warnung ist ein Hinweis auf ein signifikantes Ereignis, das Ihre Aufmerksamkeit erfordert. Regeln und Monitore können Warnungen generieren.

Beispiele

Beispiel 1: Abrufen aller neuen Warnungen

PS C:\>Get-SCOMAlert -ResolutionState 0

Dieser Befehl ruft alle Warnungen ab, die einen Auflösungsstatus von Null haben (neue Warnungen).

Beispiel 2: Abrufen aller nicht geschlossenen Warnungen

PS C:\>Get-SCOMAlert -Criteria "ResolutionState != 255 and Severity != 0"

Dieser Befehl ruft alle Warnungen ab, die keinen Auflösungsstatus von 255 (geschlossene Warnungen) aufweisen, und der Schweregrad ist nicht "Informational".

Beispiel 3: Abrufen von Warnungen mithilfe eines benutzerdefinierten Felds

PS C:\>Get-SCOMAlert -Criteria "CustomField1 = 'TestServer'"

Dieser Befehl ruft alle Warnungen ab, die einen Wert von TestServer- in der eigenschaft CustomField1 aufweisen.

Beispiel 4: Abrufen von Benachrichtigungen, die in den letzten 30 Minuten geändert wurden

PS C:\>Get-SCOMAlert -Criteria "LastModified > '$((Get-Date).AddMinutes(-30))'"

Dieser Befehl ruft alle Warnungen ab, die in den letzten 30 Minuten geändert wurden. Der von LastModified zurückgegebene Zeitwert befindet sich in UTC, während Get-Date die Lokale Systemzeit aufweist.

Beispiel 5: Abrufen von Warnungen und Unterdrücken von Fehlermeldungen

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

In diesem Beispiel werden Warnungen abgerufen und Fehlermeldungen für die Klasseninstanzen unterdrückt, die nicht den Kriterien des Befehls entsprechen.

Der erste Befehl speichert den Wert der variablen $ErrorActionPreference in der variablen $OriginalErrorAction.

Der zweite Befehl legt den Wert der $ErrorActionPreference Variablen auf SilentlyContinue fest. Durch Festlegen des Werts der $ErrorActionPreference Variablen auf SilentlyContinue werden Klasseninstanzen, die keine übereinstimmenden Aufgabenergebnisse aufweisen, weiterhin ausgeführt und kein Fehler angezeigt.

Der dritte Befehl ruft alle Klassen mit Integrität im Namen ab und übergibt die Klassenobjekte mithilfe des Pipelineoperators an die Get-SCOMClassInstance Cmdlet. Die Get-SCOMClassInstance ruft die Klasseninstanzen für jedes Klassenobjekt ab und übergibt die einzelnen Klasseninstanzobjekte an das cmdlet Get-SCOMAlert. Das cmdlet Get-SCOMAlert gibt die Warnungen zurück, die einen Auflösungsstatus von 5 bis einschließlich 200 für jede Klasseninstanz aufweisen.

Der vierte Befehl legt den Wert für die variable $ErrorActionPreference wieder auf den Wert fest, der in der variablen $OriginalErrorAction gespeichert ist.

Beispiel 6: Abrufen einer Benachrichtigung mithilfe der ID

PS C:\>Get-SCOMAlert -Id 7413b06b-a95b-4ae3-98f2-dac9ff76dabd

Dieser Befehl ruft die Warnung ab, die die ID 7413b06b-a95b-4ae3-98f2-dac9ff76dabd hat.

Parameter

-ComputerName

Gibt ein Array von Namen von Computern an. Sie können NetBIOS-Namen, IP-Adressen oder vollqualifizierte Domänennamen (FQDNs) verwenden. Um den lokalen Computer anzugeben, geben Sie den Computernamen, den Localhost oder einen Punkt (.) ein.

Der System Center Data Access-Dienst muss auf dem Computer ausgeführt werden. Wenn Sie keinen Computer angeben, verwendet das Cmdlet den Computer für die aktuelle Verwaltungsgruppenverbindung.

Typ:String[]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Credential

Gibt ein PSCredential- -Objekt für die Verwaltungsgruppenverbindung an. Um ein PSCredential-Objekt abzurufen, verwenden Sie das Cmdlet Get-Credential. Geben Sie Get-Help Get-Credentialein, um weitere Informationen zu erfahren.

Wenn Sie einen Computer im parameter ComputerName angeben, verwenden Sie ein Konto, das Zugriff auf diesen Computer hat. Die Standardeinstellung ist der aktuelle Benutzer.

Typ:PSCredential
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Criteria

Gibt die Kriterien-XML an, die angibt, wie Warnungen gefiltert werden. Kriterien können nach bestimmten Regeln oder Monitoren oder Eigenschaften der Warnung filtern, aber nicht nach Klassen oder Gruppen filtern. Weitere Details finden Sie hier: https://learn.microsoft.com/previous-versions/system-center/developer/bb437603(v=msdn.10)?redirectedfrom=MSDN

Typ:String
Position:10
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-HealthState

Gibt ein Array von Integritätszuständen an. Gültige Werte sind: kritisch (rot), Warnung (gelb), fehlerfrei (grün).

Typ:String[]
Position:7
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Id

Gibt ein Array von GUIDs von Warnungsobjekten an. Um die ID einer Warnung zu erhalten, geben Sie "Get-SCOMAlert | Format-Table Name, Id" ein.

Typ:Guid[]
Position:1
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Instance

Gibt ein Array von Klasseninstanzobjekten an. Dieser Parameter akzeptiert auch Gruppenobjekte. Verwenden Sie zum Abrufen eines Klasseninstanzobjekts das cmdlet Get-SCOMClassInstance. Geben Sie Get-Help Get-SCOMClassInstanceein, um weitere Informationen zu erfahren.

Typ:EnterpriseManagementObject[]
Position:1
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-LastModifiedBy

Gibt ein Array von Benutzernamen an. Das Cmdlet ruft die Warnungen ab, wenn der letzte Benutzer, der die Warnung bearbeitet hat, mit einem von Ihnen angegebenen Benutzernamen übereinstimmt.

Typ:String[]
Position:2
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:True

-Name

Gibt ein Array von Warnungsnamen an. Das Cmdlet ruft die Warnungen ab, die den von Ihnen angegebenen Warnungsnamen entsprechen.

Typ:String[]
Position:3
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:True

-Owner

Gibt ein Array von Benutzernamen an. Das Cmdlet erhält eine Warnung, wenn der Besitzer einer Warnung mit einem von Ihnen angegebenen Benutzernamen übereinstimmt.

Typ:String[]
Position:4
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:True

-Priority

Gibt ein Array von Warnungsprioirty-Ebenen an. Gültige Werte sind:

  • Niedrig
  • Mittel
  • Hoch
Typ:String[]
Position:8
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ResolutionState

Gibt ein Array von Auflösungsstatus-IDs an.

Wenn eine Warnung generiert wird, ist der Auflösungsstatus "Neu". Operatoren können den Auflösungsstatus für eine neue Warnung in "Geschlossen" oder in einen benutzerdefinierten Auflösungszustand ändern, den ein Administrator für die Verwaltungsgruppe erstellt hat. Die ID für "Neu" ist 0, und die ID für "Geschlossen" ist 255. Sie können benutzerdefinierte Auflösungszustände von 2 bis 254 zuweisen.

Typ:Int32[]
Position:5
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:True

-ResolvedBy

Gibt ein Array von Benutzernamen an. Das Cmdlet ruft die Warnungen ab, wenn der Benutzer, der die Warnung aufgelöst hat, mit einem von Ihnen angegebenen Benutzernamen übereinstimmt.

Typ:String[]
Position:6
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:True

-SCSession

Gibt ein Array von Connection -Objekten an. Um ein Connection-Objekt abzurufen, verwenden Sie das Cmdlet Get-SCOMManagementGroupConnection.

Ein Verbindungsobjekt stellt eine Verbindung mit einem Verwaltungsserver dar. Der Standardwert ist die aktuelle Verwaltungsgruppenverbindung.

Typ:Connection[]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Severity

Gibt ein Array von Schweregradwerten von Warnungen an. Gültige Werte sind:

  • Information
  • Warnung
  • Kritisch
Typ:String[]
Position:9
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False