Udostępnij przez


Get-SCOMAlert

Pobiera alerty programu Operations Manager.

Składnia

Empty (Domyślna)

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

Opis

Polecenie cmdlet Get-SCOMAlert pobiera co najmniej jeden alert. Alert wskazuje na ważne zdarzenie, które wymaga Twojej uwagi. Reguły i monitory mogą generować alerty.

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 równy zero (nowe alerty).

Przykład 2: Pobierz wszystkie alerty, które nie zostały zamknięte

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

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

Przykład 3: Otrzymywanie 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: Modyfikowanie alertów 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 czasu lokalnego systemowego.

Przykład 5: Otrzymywanie 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

W tym przykładzie pobierane są alerty i pomijane są komunikaty o błędach dla wystąpień klasy, 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 klasy, które nie mają pasujących wyników zadania, będą nadal działać i nie będą wyświetlać błędu.

Trzecie polecenie pobiera wszystkie klasy z kondycją w nazwie i przekazuje obiekty klasy do polecenia cmdlet Get-SCOMClassInstance przy użyciu operatora potoku. Get-SCOMClassInstance pobiera wystąpienia klasy dla każdego obiektu klasy i przekazuje każdy z obiektów wystąpienia klasy do polecenia cmdlet Get-SCOMAlert. Polecenie cmdlet Get-SCOMAlert zwraca alerty, które mają stan rozwiązania 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: Otrzymywanie 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żna używać nazw NetBIOS, adresów IP lub w pełni kwalifikowanych nazw domen (FQDN). Aby określić komputer lokalny, wpisz nazwę komputera, localhost lub kropkę (.).

Na komputerze musi być uruchomiona usługa System Center Data Access. Jeśli komputer nie zostanie określony, polecenie cmdlet użyje komputera do bieżącego połączenia grupy zarządzania.

Właściwości parametru

Typ:

String[]

Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów: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 Get-Help Get-Credential.

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

Właściwości parametru

Typ:PSCredential
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-Criteria

Określa kryteria XML wskazujące sposób filtrowania alertów. Kryteria mogą filtrować według określonych reguł lub monitorów lub właściwości alertu, ale nie mogą filtrować według 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

Właściwości parametru

Typ:String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

FromCriteria
Position:10
Obowiązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-HealthState

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

Właściwości parametru

Typ:

String[]

Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

FromAlertDefault
Position:7
Obowiązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-Id

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

Właściwości parametru

Typ:

Guid[]

Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

FromAlertId
Position:1
Obowiązkowy:True
Wartość z potoku:True
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-Instance

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

Właściwości parametru

Typ:

EnterpriseManagementObject[]

Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

FromAlertDefault
Position:1
Obowiązkowy:False
Wartość z potoku:True
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-LastModifiedBy

Określa tablicę nazw użytkowników. Polecenie cmdlet pobiera alerty, jeśli ostatni użytkownik, który edytował alert, jest zgodny z określoną nazwą użytkownika.

Właściwości parametru

Typ:

String[]

Domyślna wartość:None
Obsługuje symbole wieloznaczne:True
DontShow:False

Zestawy parametrów

FromAlertDefault
Position:2
Obowiązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-Name

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

Właściwości parametru

Typ:

String[]

Domyślna wartość:None
Obsługuje symbole wieloznaczne:True
DontShow:False

Zestawy parametrów

FromAlertDefault
Position:3
Obowiązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-Owner

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

Właściwości parametru

Typ:

String[]

Domyślna wartość:None
Obsługuje symbole wieloznaczne:True
DontShow:False

Zestawy parametrów

FromAlertDefault
Position:4
Obowiązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-Priority

Określa tablicę poziomów pierwszeństwa alertów. Prawidłowe wartości to:

  • Niski
  • Średni
  • Wysoki

Właściwości parametru

Typ:

String[]

Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

FromAlertDefault
Position:8
Obowiązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-ResolutionState

Określa tablicę identyfikatorów stanów rozpoznawania.

Po wygenerowaniu alertu jego stan rozwiązania to Nowy. Operatorzy mogą zmienić stan rozwiązywania nowego alertu na Zamknięty lub niestandardowy stan rozwiązania utworzony przez administratora dla grupy zarządzania. Identyfikator dla nowego to 0, a identyfikator dla zamkniętego to 255. Niestandardowym stanom rozdzielczości można przypisać dowolną wartość z zakresu od 2 do 254.

Właściwości parametru

Typ:

Int32[]

Domyślna wartość:None
Obsługuje symbole wieloznaczne:True
DontShow:False

Zestawy parametrów

FromAlertDefault
Position:5
Obowiązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-ResolvedBy

Określa tablicę nazw użytkowników. Polecenie cmdlet pobiera alerty, jeśli użytkownik, który rozwiązał alert, jest zgodny z określoną nazwą użytkownika.

Właściwości parametru

Typ:

String[]

Domyślna wartość:None
Obsługuje symbole wieloznaczne:True
DontShow:False

Zestawy parametrów

FromAlertDefault
Position:6
Obowiązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-SCSession

Określa tablicę obiektów połączenia . Aby uzyskać obiekt Connection , 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.

Właściwości parametru

Typ:

Connection[]

Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-Severity

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

  • Informacja
  • Ostrzeżenie
  • Krytyczny

Właściwości parametru

Typ:

String[]

Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

FromAlertDefault
Position:9
Obowiązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

CommonParameters

To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.