Auf Englisch lesen

Freigeben über

Get-SCOMAlert

  • Referenz
Modul:
OperationsManager

Ruft Operations Manager-Warnungen ab.

Syntax

PowerShell 
Get-SCOMAlert
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [<CommonParameters>]
PowerShell 
Get-SCOMAlert
   [-Id] <Guid[]>
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [<CommonParameters>]
PowerShell 
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>]
PowerShell 
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 wichtiges Ereignis, das Ihre Aufmerksamkeit erfordert. Warnungen können von Regeln und Monitore generiert werden.

Beispiele

Beispiel 1: Abrufen aller neuen Warnungen

PowerShell 
PS C:\>Get-SCOMAlert -ResolutionState 0

Mit diesem Befehl werden alle Warnungen abgerufen, die den Auflösungsstatus 0 (neue Warnungen) aufweisen.

Beispiel 2: Abrufen aller nicht geschlossenen Warnungen

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

Mit diesem Befehl werden alle Warnungen abgerufen, die nicht den Auflösungsstatus 255 (geschlossene Warnungen) aufweisen und der Schweregrad nicht Informal lautet.

Beispiel 3: Abrufen von Warnungen mithilfe eines benutzerdefinierten Felds

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

Mit diesem Befehl werden alle Warnungen abgerufen, die den Wert TestServer in der CustomField1-Eigenschaft aufweisen.

Beispiel 4: Ändern von Warnungen in den letzten 30 Minuten

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

Mit diesem Befehl werden alle Warnungen abgerufen, die in den letzten 30 Minuten geändert wurden. Der von LastModified zurückgegebene Zeitwert ist IN UTC, während Get-Date die lokale Systemzeit ist.

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

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

Mit dem zweiten Befehl wird der Wert der variablen $ErrorActionPreference auf SilentlyContinue festgelegt. Wenn Sie den Wert der $ErrorActionPreference Variablen auf SilentlyContinue festlegen, werden Klasseninstanzen, die keine übereinstimmenden Aufgabenergebnisse aufweisen, weiterhin ausgeführt, und es wird kein Fehler angezeigt.

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

Mit dem vierten Befehl wird der Wert für die variable $ErrorActionPreference wieder auf den Wert festgelegt, der in der variablen $OriginalErrorAction gespeichert ist.

Beispiel 6: Abrufen einer Warnung mithilfe der ID

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

Mit diesem Befehl wird die Warnung mit der ID 7413b06b-a95b-4ae3-98f2-dac9ff76dabd abgerufen.

Parameter

-ComputerName

Gibt ein Array von Namen von Computern an. Sie können NetBIOS-Namen, IP-Adressen oder vollqualifizierte Domänennamen (FQDNs) verwenden. Geben Sie zum Angeben des lokalen Computers den Computernamen, 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.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Credential

Gibt ein PSCredential-Objekt für die Verwaltungsgruppenverbindung an. Verwenden Sie zum Abrufen eines PSCredential-Objekts das Get-Credential-Cmdlet. Geben Sie Folgendes ein, um weitere Informationen zu erhalten: Get-Help Get-Credential.

Wenn Sie einen Computer im ComputerName-Parameter angeben, verwenden Sie ein Konto, das Zugriff auf diesen Computer hat. Der Standardwert ist der aktuelle Benutzer.

Type:PSCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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

Type:String
Position:10
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-HealthState

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

Type:String[]
Position:7
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Id

Gibt ein Array von GUIDs von Warnungsobjekten an. Geben Sie "Get-SCOMAlert | Format-Table Name, Id" ein, um die ID einer Warnung abzurufen.

Type:Guid[]
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Instance

Gibt ein Array von Klassenobjekten instance an. Dieser Parameter akzeptiert auch Gruppenobjekte. Verwenden Sie das Cmdlet Get-SCOMClassInstance, um eine Klasse instance -Objekt abzurufen. Geben Sie Folgendes ein, um weitere Informationen zu erhalten: Get-Help Get-SCOMClassInstance.

Type:EnterpriseManagementObject[]
Position:1
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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.

Type:String[]
Position:2
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:True

-Name

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

Type:String[]
Position:3
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:True

-Owner

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

Type:String[]
Position:4
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:True

-Priority

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

  • Niedrig
  • Medium
  • Hoch
Type:String[]
Position:8
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ResolutionState

Gibt ein Array von Auflösungsstatus-IDs an.

Wenn eine Warnung generiert wird, hat sie den Auflösungsstatus Neu. Operatoren können den Auflösungsstatus für eine neue Warnung in „Geschlossen“ oder einen benutzerdefinierten Auflösungsstatus ä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 einen beliebigen Wert von 2 bis 254 zuweisen.

Type:Int32[]
Position:5
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:String[]
Position:6
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:True

-SCSession

Gibt ein Array von Connection-Objekten an. Verwenden Sie zum Abrufen eines Connection-Objekts das Cmdlet Get-SCOMManagementGroupConnection .

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

Type:Connection[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Severity

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

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