Delen via

Get-SCOMAlert

  • Referentie
Module:
OperationsManager

Hiermee worden Operations Manager-waarschuwingen ontvangen.

Syntaxis

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

De cmdlet Get-SCOMAlert ontvangt een of meer waarschuwingen. Een waarschuwing is een indicatie van een belangrijke gebeurtenis die uw aandacht vereist. Regels en monitors kunnen waarschuwingen genereren.

Voorbeelden

Voorbeeld 1: Alle nieuwe waarschuwingen ophalen

PS C:\>Get-SCOMAlert -ResolutionState 0

Met deze opdracht worden alle waarschuwingen met een oplossingsstatus nul (nieuwe waarschuwingen) weergegeven.

Voorbeeld 2: Alle niet-gesloten waarschuwingen ophalen

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

Met deze opdracht worden alle waarschuwingen opgehaald die geen oplossingsstatus van 255 (gesloten waarschuwingen) hebben en de ernst niet informatief is.

Voorbeeld 3: Waarschuwingen ophalen met behulp van een aangepast veld

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

Met deze opdracht worden alle waarschuwingen opgehaald met een waarde van TestServer in de eigenschap CustomField1.

Voorbeeld 4: Waarschuwingen ontvangen die in de afgelopen 30 minuten zijn gewijzigd

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

Met deze opdracht worden alle waarschuwingen ontvangen die in de afgelopen 30 minuten zijn gewijzigd. De tijdwaarde die wordt geretourneerd uit LastModified- is in UTC, terwijl Get-Date van lokale systeemtijd is.

Voorbeeld 5: Waarschuwingen ophalen en foutberichten onderdrukken

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 dit voorbeeld worden waarschuwingen ontvangen en foutberichten onderdrukt voor de klasse-exemplaren die niet voldoen aan de criteria van de opdracht.

Met de eerste opdracht wordt de waarde van de $ErrorActionPreference variabele opgeslagen in de variabele $OriginalErrorAction.

Met de tweede opdracht wordt de waarde van de variabele $ErrorActionPreference ingesteld op SilentlyContinue. Door de waarde van de variabele $ErrorActionPreference in te stellen op SilentlyContinue, blijven klasse-exemplaren zonder overeenkomende taakresultaten actief en worden er geen fout weergegeven.

Met de derde opdracht worden alle klassen met de status in hun naam opgehaald en worden de klasseobjecten doorgegeven aan de Get-SCOMClassInstance cmdlet met behulp van de pijplijnoperator. De Get-SCOMClassInstance- haalt de klasse-exemplaren voor elk klasseobject op en geeft elk van de klasse-exemplaarobjecten door aan de Get-SCOMAlert-cmdlet. De cmdlet Get-SCOMAlert retourneert de waarschuwingen met een oplossingsstatus van 5 tot en met 200, inclusief, voor elk klasse-exemplaar.

Met de vierde opdracht wordt de waarde voor de $ErrorActionPreference variabele teruggezet op de waarde die is opgeslagen in de $OriginalErrorAction variabele.

Voorbeeld 6: Een waarschuwing ophalen met behulp van de id

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

Met deze opdracht wordt de waarschuwing opgehaald met de id 7413b06b-a95b-4ae3-98f2-dac9ff76dabd.

Parameters

-ComputerName

Hiermee geeft u een matrix van namen van computers. U kunt NetBIOS-namen, IP-adressen of FQDN's (Fully Qualified Domain Names) gebruiken. Als u de lokale computer wilt opgeven, typt u de computernaam, localhost of een punt (.).

De System Center Data Access-service moet worden uitgevoerd op de computer. Als u geen computer opgeeft, gebruikt de cmdlet de computer voor de huidige beheergroepverbinding.

Type:String[]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Credential

Hiermee geeft u een PSCredential-object voor de verbinding met de beheergroep. Als u een PSCredential--object wilt verkrijgen, gebruikt u de cmdlet Get-Credential. Typ Get-Help Get-Credentialvoor meer informatie.

Als u een computer opgeeft in de parameter ComputerName, gebruikt u een account dat toegang heeft tot die computer. De standaardwaarde is de huidige gebruiker.

Type:PSCredential
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Criteria

Hiermee geeft u de criteria XML die aangeeft hoe u waarschuwingen filtert. Criteria kunnen filteren op bepaalde regels of monitors of eigenschappen van de waarschuwing, maar kunnen niet filteren op klassen of groepen. Meer informatie vindt u hier: https://learn.microsoft.com/previous-versions/system-center/developer/bb437603(v=msdn.10)?redirectedfrom=MSDN

Type:String
Position:10
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-HealthState

Hiermee geeft u een matrix van statussen. Geldige waarden zijn: kritiek (rood), waarschuwing (geel), in orde (groen).

Type:String[]
Position:7
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Id

Hiermee geeft u een matrix van GUID's van waarschuwingsobjecten. Als u de id van een waarschuwing wilt ophalen, typt u 'Get-SCOMAlert | Format-Table Name, Id'.

Type:Guid[]
Position:1
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Instance

Hiermee geeft u een matrix van klasse-exemplaarobjecten. Deze parameter accepteert ook groepsobjecten. Als u een klasse-exemplaarobject wilt verkrijgen, gebruikt u de Get-SCOMClassInstance-cmdlet. Typ Get-Help Get-SCOMClassInstancevoor meer informatie.

Type:EnterpriseManagementObject[]
Position:1
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-LastModifiedBy

Hiermee geeft u een matrix van gebruikersnamen. De cmdlet ontvangt de waarschuwingen als de laatste gebruiker die de waarschuwing heeft bewerkt overeenkomt met een gebruikersnaam die u opgeeft.

Type:String[]
Position:2
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:True

-Name

Hiermee geeft u een matrix van waarschuwingsnamen. De cmdlet haalt de waarschuwingen op die overeenkomen met de waarschuwingsnamen die u opgeeft.

Type:String[]
Position:3
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:True

-Owner

Hiermee geeft u een matrix van gebruikersnamen. De cmdlet ontvangt een waarschuwing als de eigenaar van een waarschuwing overeenkomt met een gebruikersnaam die u opgeeft.

Type:String[]
Position:4
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:True

-Priority

Hiermee geeft u een matrix van waarschuwingsniveaus. Geldige waarden zijn:

  • Laag
  • Gemiddeld
  • Hoog
Type:String[]
Position:8
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-ResolutionState

Hiermee geeft u een matrix van resolutiestatus-id's.

Wanneer een waarschuwing wordt gegenereerd, is de oplossingsstatus Nieuw. Operators kunnen de oplossingsstatus voor een nieuwe waarschuwing wijzigen in Gesloten of in een aangepaste oplossingsstatus die een beheerder heeft gemaakt voor de beheergroep. De id voor Nieuw is 0 en de id voor Gesloten is 255. U kunt aangepaste oplossingsstatussen elke waarde van 2 tot en met 254 toewijzen.

Type:Int32[]
Position:5
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:True

-ResolvedBy

Hiermee geeft u een matrix van gebruikersnamen. De cmdlet ontvangt de waarschuwingen als de gebruiker die de waarschuwing heeft opgelost overeenkomt met een gebruikersnaam die u opgeeft.

Type:String[]
Position:6
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:True

-SCSession

Hiermee geeft u een matrix van Connection-objecten. Als u een Connection-object wilt verkrijgen, gebruikt u de cmdlet Get-SCOMManagementGroupConnection.

Een verbindingsobject vertegenwoordigt een verbinding met een beheerserver. De standaardwaarde is de huidige verbinding met de beheergroep.

Type:Connection[]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Severity

Hiermee geeft u een matrix met ernstwaarden van waarschuwingen. Geldige waarden zijn:

  • Informatie
  • Waarschuwing
  • Kritisch
Type:String[]
Position:9
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False