Udostępnij za pośrednictwem

Get-SCOMAlert

  • Odwołanie
Moduł:
OperationsManager

Pobiera alerty programu Operations Manager.

Składnia

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

Opis

Polecenie cmdlet Get-SCOMAlert pobiera co najmniej jeden alert. Alert jest wskazaniem istotnego zdarzenia, które wymaga uwagi. Alerty mogą być generowane przez zasady i monitory.

Przykłady

Przykład 1. Pobieranie wszystkich nowych alertów

PS C:\>Get-SCOMAlert -ResolutionState 0

To polecenie pobiera wszystkie alerty, które mają stan rozwiązania zero (nowe alerty).

Przykład 2. Pobieranie wszystkich nie zamkniętych alertów

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

To polecenie pobiera wszystkie alerty, które nie mają stanu rozwiązania 255 (zamknięte alerty), a ważność nie jest informacyjna.

Przykład 3. Pobieranie alertów przy użyciu pola niestandardowego

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

To polecenie pobiera wszystkie alerty, które mają wartość TestServer we właściwości CustomField1 .

Przykład 4. Pobieranie alertów zmodyfikowanych w ciągu ostatnich 30 minut

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

To polecenie pobiera wszystkie alerty, które zostały zmodyfikowane w ciągu ostatnich 30 minut. Wartość czasu zwrócona z lastModified jest w formacie UTC, podczas gdy Get-Date jest czasem systemu lokalnego.

Przykład 5. Pobieranie alertów i pomijanie komunikatów o błędach

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

Ten przykład pobiera alerty i pomija komunikaty o błędach dla wystąpień klas, które nie spełniają kryteriów polecenia.

Pierwsze polecenie przechowuje wartość zmiennej $ErrorActionPreference w zmiennej $OriginalErrorAction.

Drugie polecenie ustawia wartość zmiennej $ErrorActionPreference na SilentlyContinue. Ustawiając wartość zmiennej $ErrorActionPreference na SilentlyContinue, wystąpienia klas, które nie mają pasujących wyników zadań, są nadal uruchamiane i nie pokazują błędu.

Trzecie polecenie pobiera wszystkie klasy o kondycji w nazwie i przekazuje obiekty klasy do polecenia cmdlet Get-SCOMClassInstance przy użyciu operatora potoku. Klasa Get-SCOMClassInstance pobiera wystąpienia klas dla każdego obiektu klasy i przekazuje każdy obiekt wystąpienia klasy do polecenia cmdlet Get-SCOMAlert . Polecenie cmdlet Get-SCOMAlert zwraca alerty, które mają stan rozwiązania z zakresu od 5 do 200 włącznie dla każdego wystąpienia klasy.

Czwarte polecenie ustawia wartość zmiennej $ErrorActionPreference z powrotem na wartość przechowywaną w zmiennej $OriginalErrorAction.

Przykład 6. Uzyskiwanie alertu przy użyciu identyfikatora

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

To polecenie pobiera alert o identyfikatorze 7413b06b-a95b-4ae3-98f2-dac9ff76dabd.

Parametry

-ComputerName

Określa tablicę nazw komputerów. Możesz użyć nazw NetBIOS, adresów IP lub w pełni kwalifikowanych nazw domen (FQDN). Aby określić komputer lokalny, wpisz nazwę komputera, localhost lub kropkę (.).

Usługa System Center Data Access musi być uruchomiona na komputerze. Jeśli nie określisz komputera, polecenie cmdlet używa komputera do bieżącego połączenia grupy zarządzania.

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

-Credential

Określa obiekt PSCredential dla połączenia grupy zarządzania. Aby uzyskać obiekt PSCredential , użyj polecenia cmdlet Get-Credential . Aby uzyskać więcej informacji, wpisz polecenie Get-Help Get-Credential.

Jeśli określisz komputer w parametrze ComputerName , użyj konta, które ma dostęp do tego komputera. Wartość domyślna to użytkownik bieżący.

Type:PSCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Criteria

Określa kryteria XML wskazujące sposób filtrowania alertów. Kryteria mogą filtrować określone reguły lub monitory lub właściwości alertu, ale nie mogą filtrować klas lub grup. Więcej szczegółów można znaleźć tutaj: 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

Określa tablicę stanów kondycji. Prawidłowe wartości to: krytyczne (czerwone), ostrzeżenie (żółty), w dobrej kondycji (zielony).

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

-Id

Określa tablicę identyfikatorów GUID obiektów alertu. Aby uzyskać identyfikator alertu, wpisz "Get-SCOMAlert | Format-Table Name, Id".

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

-Instance

Określa tablicę obiektów wystąpień klasy. Ten parametr akceptuje również obiekty grupy. Aby uzyskać obiekt wystąpienia klasy, użyj polecenia cmdlet Get-SCOMClassInstance . Aby uzyskać więcej informacji, wpisz polecenie Get-Help Get-SCOMClassInstance.

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

-LastModifiedBy

Określa tablicę nazw użytkowników. Polecenie cmdlet pobiera alerty, jeśli ostatni użytkownik, który edytował alert, pasuje do określonej nazwy użytkownika.

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

-Name

Określa tablicę nazw alertów. Polecenie cmdlet pobiera alerty zgodne z określonymi nazwami alertów.

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

-Owner

Określa tablicę nazw użytkowników. Polecenie cmdlet otrzymuje alert, jeśli właściciel alertu jest zgodny z podaną nazwą użytkownika.

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

-Priority

Określa tablicę poziomów alertu prioirty. Prawidłowe wartości:

  • Niski
  • Śred.
  • Wys.
Type:String[]
Position:8
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ResolutionState

Określa tablicę identyfikatorów stanu rozpoznawania.

Po wygenerowaniu alertu jego stanem rozwiązywania jest Nowy. Operatorzy mogą zmienić stan rozwiązywania dla nowego alertu na Zamknięty lub na niestandardowy stan rozwiązywania, który utworzył administrator dla grupy zarządzania. Identyfikator nowego to 0, a identyfikator dla zamkniętego to 255. Możesz przypisać niestandardową rozdzielczość dowolną wartość z zakresu od 2 do 254.

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

-ResolvedBy

Określa tablicę nazw użytkowników. Polecenie cmdlet pobiera alerty, jeśli użytkownik, który rozpoznał alert, pasuje do określonej nazwy użytkownika.

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

-SCSession

Określa tablicę obiektów Połączenia . Aby uzyskać obiekt Połączenia , użyj polecenia cmdlet Get-SCOMManagementGroupConnection .

Obiekt połączenia reprezentuje połączenie z serwerem zarządzania. Wartość domyślna to bieżące połączenie grupy zarządzania.

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

-Severity

Określa tablicę wartości ważności alertów. Prawidłowe wartości:

  • Informacje
  • Ostrzeżenie
  • Krytyczne
Type:String[]
Position:9
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False