Polecenie cmdlet Add-SCOMNotificationChannel dodaje kanał powiadomień w programie System Center — Operations Manager.
Kanały powiadomień informują administratorów o alercie lub uruchamiają automatyzację w odpowiedzi na alert.
Kanał powiadomień używa mechanizmu dostarczania w programie Operations Manager, takiego jak poczta e-mail, wiadomości błyskawiczne (IM), krótka usługa wiadomości (SMS) lub polecenie, aby dostarczać powiadomienia.
W tym przykładzie dodano kanał powiadomień polecenia z uruchomionym programem OnNotify.exe.
Pierwsze polecenie przechowuje ścieżkę do pliku wykonywalnego w zmiennej o nazwie $Path.
Drugie polecenie przechowuje argumenty w zmiennej o nazwie $Arg.
Trzecie polecenie przechowuje katalog roboczy w zmiennej o nazwie $WorkingDir.
Czwarte polecenie używa polecenia cmdlet Add-SCOMNotificationChannel, aby dodać kanał powiadomień polecenia.
Parametry
-Anonymous
Wskazuje, że anonimowy serwer SMTP (Simple Mail Transfer Protocol) wysyła powiadomienia e-mail.
Właściwości parametru
Typ:
SwitchParameter
Domyślna wartość:
None
Obsługuje symbole wieloznaczne:
False
DontShow:
False
Zestawy parametrów
UsingSMTP
Position:
Named
Obowiązkowy:
False
Wartość z potoku:
False
Wartość z potoku według nazwy właściwości:
True
Wartość z pozostałych argumentów:
False
-ApplicationPath
Określa ścieżkę aplikacji kanału poleceń.
Właściwości parametru
Typ:
String
Domyślna wartość:
None
Obsługuje symbole wieloznaczne:
False
DontShow:
False
Zestawy parametrów
CommandAction
Position:
1
Obowiązkowy:
True
Wartość z potoku:
False
Wartość z potoku według nazwy właściwości:
False
Wartość z pozostałych argumentów:
False
-Argument
Określa listę argumentów do kanału poleceń.
Właściwości parametru
Typ:
String
Domyślna wartość:
None
Obsługuje symbole wieloznaczne:
False
DontShow:
False
Zestawy parametrów
CommandAction
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
-BackupDevice
Określa tablicę pomocniczych urządzeń SMS.
Właściwości parametru
Typ:
String[]
Domyślna wartość:
None
Obsługuje symbole wieloznaczne:
False
DontShow:
False
Zestawy parametrów
UsingSMS
Position:
3
Obowiązkowy:
False
Wartość z potoku:
False
Wartość z potoku według nazwy właściwości:
True
Wartość z pozostałych argumentów:
False
-BackupSmtpServer
Określa tablicę serwerów SMTP kopii zapasowych.
Serwery kopii zapasowych używają tej samej konfiguracji co podstawowy serwer SMTP.
Właściwości parametru
Typ:
String[]
Domyślna wartość:
None
Obsługuje symbole wieloznaczne:
False
DontShow:
False
Zestawy parametrów
UsingSMTP
Position:
Named
Obowiązkowy:
False
Wartość z potoku:
False
Wartość z potoku według nazwy właściwości:
True
Wartość z pozostałych argumentów:
False
-Body
Określa treść wiadomości z powiadomieniem.
Właściwości parametru
Typ:
String
Domyślna wartość:
None
Obsługuje symbole wieloznaczne:
False
DontShow:
False
Zestawy parametrów
UsingSMTP
Position:
Named
Obowiązkowy:
True
Wartość z potoku:
False
Wartość z potoku według nazwy właściwości:
True
Wartość z pozostałych argumentów:
False
UsingSIP
Position:
Named
Obowiązkowy:
True
Wartość z potoku:
False
Wartość z potoku według nazwy właściwości:
True
Wartość z pozostałych argumentów:
False
UsingSMS
Position:
Named
Obowiązkowy:
True
Wartość z potoku:
False
Wartość z potoku według nazwy właściwości:
True
Wartość z pozostałych argumentów:
False
-BodyAsHtml
Wskazuje, że usługa formatuje treść komunikatu jako HTML.
Właściwości parametru
Typ:
SwitchParameter
Domyślna wartość:
None
Obsługuje symbole wieloznaczne:
False
DontShow:
False
Zestawy parametrów
UsingSMTP
Position:
Named
Obowiązkowy:
False
Wartość z potoku:
False
Wartość z potoku według nazwy właściwości:
True
Wartość z pozostałych argumentów:
False
-ComputerName
Określa tablicę nazw komputerów.
Polecenie cmdlet ustanawia tymczasowe połączenia z grupami zarządzania dla tych komputerów.
Można 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ę (.).
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
-Confirm
Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.
Właściwości parametru
Typ:
SwitchParameter
Domyślna wartość:
False
Obsługuje symbole wieloznaczne:
False
DontShow:
False
Aliasy:
por
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
-ContentType
Określa typ zawartości wiadomości błyskawicznej.
Domyślnie typ zawartości to text/plain.
Właściwości parametru
Typ:
String
Domyślna wartość:
None
Obsługuje symbole wieloznaczne:
False
DontShow:
False
Zestawy parametrów
UsingSIP
Position:
Named
Obowiązkowy:
False
Wartość z potoku:
False
Wartość z potoku według nazwy właściwości:
True
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 ComputerName, 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
-Description
Określa opis kanału powiadomień.
Jeśli nie ustawisz wartości, wartość domyślna to wartość parametru DisplayName.
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:
True
Wartość z pozostałych argumentów:
False
-Device
Określa podstawowe urządzenie SMS.
Właściwości parametru
Typ:
String
Domyślna wartość:
None
Obsługuje symbole wieloznaczne:
False
DontShow:
False
Zestawy parametrów
UsingSMS
Position:
2
Obowiązkowy:
False
Wartość z potoku:
False
Wartość z potoku według nazwy właściwości:
True
Wartość z pozostałych argumentów:
False
-DeviceEnumerationInterval
Określa przedział czasu między powiadomieniami SMS.
Domyślnie kanał powiadomień czeka 10 sekund.
Właściwości parametru
Typ:
TimeSpan
Domyślna wartość:
None
Obsługuje symbole wieloznaczne:
False
DontShow:
False
Zestawy parametrów
UsingSMS
Position:
Named
Obowiązkowy:
False
Wartość z potoku:
False
Wartość z potoku według nazwy właściwości:
True
Wartość z pozostałych argumentów:
False
-DisplayName
Określa nazwę wyświetlaną kanału powiadomień.
Jeśli nie ustawisz wartości, wartość domyślna to wartość parametru Name.
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:
True
Wartość z pozostałych argumentów:
False
-Encoding
Określa format kodowania komunikatu powiadomienia.
Kanał SMTP domyślnie używa kodowania UTF-8.
Kanał wiadomości błyskawicznych domyślnie używa kodowania UTF-8.
Kanał SMS domyślnie używa domyślnego kodowania, ale może również używać kodowania Unicode.
Właściwości parametru
Typ:
String
Domyślna wartość:
None
Obsługuje symbole wieloznaczne:
False
DontShow:
False
Zestawy parametrów
UsingSMTP
Position:
Named
Obowiązkowy:
False
Wartość z potoku:
False
Wartość z potoku według nazwy właściwości:
True
Wartość z pozostałych argumentów:
False
UsingSIP
Position:
Named
Obowiązkowy:
False
Wartość z potoku:
False
Wartość z potoku według nazwy właściwości:
True
Wartość z pozostałych argumentów:
False
UsingSMS
Position:
Named
Obowiązkowy:
False
Wartość z potoku:
False
Wartość z potoku według nazwy właściwości:
True
Wartość z pozostałych argumentów:
False
-ExternalEmail
Określa, czy używać zewnętrznej poczty e-mail.
Właściwości parametru
Typ:
SwitchParameter
Domyślna wartość:
None
Obsługuje symbole wieloznaczne:
False
DontShow:
False
Zestawy parametrów
UsingSMTP
Position:
Named
Obowiązkowy:
False
Wartość z potoku:
False
Wartość z potoku według nazwy właściwości:
True
Wartość z pozostałych argumentów:
False
-ExternalEmailRunasProfile
Określa profil Uruchom jako dla zewnętrznej poczty e-mail.
Właściwości parametru
Typ:
String
Domyślna wartość:
None
Obsługuje symbole wieloznaczne:
False
DontShow:
False
Zestawy parametrów
UsingSMTP
Position:
Named
Obowiązkowy:
False
Wartość z potoku:
False
Wartość z potoku według nazwy właściwości:
True
Wartość z pozostałych argumentów:
False
-From
Określa nagłówek From w wiadomości e-mail z powiadomieniem.
Właściwości parametru
Typ:
String
Domyślna wartość:
None
Obsługuje symbole wieloznaczne:
False
DontShow:
False
Zestawy parametrów
UsingSMTP
Position:
2
Obowiązkowy:
True
Wartość z potoku:
False
Wartość z potoku według nazwy właściwości:
True
Wartość z pozostałych argumentów:
False
-Header
Określa nagłówki jako pary klucz-wartość w wiadomości e-mail z powiadomieniem.
Właściwości parametru
Typ:
Hashtable
Domyślna wartość:
None
Obsługuje symbole wieloznaczne:
False
DontShow:
False
Zestawy parametrów
UsingSMTP
Position:
Named
Obowiązkowy:
False
Wartość z potoku:
False
Wartość z potoku według nazwy właściwości:
True
Wartość z pozostałych argumentów:
False
-MaxPrimaryRecipientsPerMail
Określa maksymalną liczbę adresatów wiadomości e-mail z powiadomieniem.
Właściwości parametru
Typ:
Int32
Domyślna wartość:
None
Obsługuje symbole wieloznaczne:
False
DontShow:
False
Zestawy parametrów
UsingSMTP
Position:
Named
Obowiązkowy:
False
Wartość z potoku:
False
Wartość z potoku według nazwy właściwości:
True
Wartość z pozostałych argumentów:
False
-Name
Określa nazwę kanału powiadomień.
Właściwości parametru
Typ:
String
Domyślna wartość:
None
Obsługuje symbole wieloznaczne:
False
DontShow:
False
Zestawy parametrów
(All)
Position:
1
Obowiązkowy:
True
Wartość z potoku:
False
Wartość z potoku według nazwy właściwości:
True
Wartość z pozostałych argumentów:
False
-NoSubjectEncoding
Wskazuje, że polecenie cmdlet nie koduje wiersza tematu wiadomości e-mail.
Właściwości parametru
Typ:
SwitchParameter
Domyślna wartość:
None
Obsługuje symbole wieloznaczne:
False
DontShow:
False
Zestawy parametrów
UsingSMTP
Position:
Named
Obowiązkowy:
False
Wartość z potoku:
False
Wartość z potoku według nazwy właściwości:
True
Wartość z pozostałych argumentów:
False
-Port
Określa numer portu dla kanału.
Kanał SMTP domyślnie używa portu 25.
Kanał wiadomości błyskawicznych korzystający z protokołu TCP domyślnie używa portu 5060, a kanał wiadomości błyskawicznych korzystający z protokołu Transport Layer Security (TLS) domyślnie używa portu 5061.
Właściwości parametru
Typ:
UInt32
Domyślna wartość:
None
Obsługuje symbole wieloznaczne:
False
DontShow:
False
Zestawy parametrów
UsingSMTP
Position:
Named
Obowiązkowy:
False
Wartość z potoku:
False
Wartość z potoku według nazwy właściwości:
True
Wartość z pozostałych argumentów:
False
UsingSIP
Position:
Named
Obowiązkowy:
False
Wartość z potoku:
False
Wartość z potoku według nazwy właściwości:
True
Wartość z pozostałych argumentów:
False
-PreferredUserName
Określa preferowaną nazwę użytkownika kanału wiadomości błyskawicznych.
Jeśli nie ustawisz wartości, wartość domyślna to wartość parametru Username.
Właściwości parametru
Typ:
String
Domyślna wartość:
None
Obsługuje symbole wieloznaczne:
False
DontShow:
False
Zestawy parametrów
UsingSIP
Position:
Named
Obowiązkowy:
False
Wartość z potoku:
False
Wartość z potoku według nazwy właściwości:
True
Wartość z pozostałych argumentów:
False
-PrimaryRetryInterval
Określa interwał ponawiania prób.
Usługa próbuje przełączyć się z powrotem do podstawowego serwera SMTP lub urządzenia SMS.
Domyślnie interwał wynosi pięć minut.
Właściwości parametru
Typ:
TimeSpan
Domyślna wartość:
None
Obsługuje symbole wieloznaczne:
False
DontShow:
False
Zestawy parametrów
UsingSMTP
Position:
Named
Obowiązkowy:
False
Wartość z potoku:
False
Wartość z potoku według nazwy właściwości:
True
Wartość z pozostałych argumentów:
False
UsingSMS
Position:
Named
Obowiązkowy:
False
Wartość z potoku:
False
Wartość z potoku według nazwy właściwości:
True
Wartość z pozostałych argumentów:
False
-ReplyTo
Określa nagłówek Reply-to w wiadomości e-mail z powiadomieniem.
Właściwości parametru
Typ:
String
Domyślna wartość:
None
Obsługuje symbole wieloznaczne:
False
DontShow:
False
Zestawy parametrów
UsingSMTP
Position:
Named
Obowiązkowy:
False
Wartość z potoku:
False
Wartość z potoku według nazwy właściwości:
True
Wartość z pozostałych argumentów:
False
-SCSession
Określa tablicę obiektów połączenia .
Aby uzyskać obiekt Connection, użyj polecenia cmdlet Get-SCManagementGroupConnection.
Wprowadź obiekt połączenia dla grupy zarządzania, na przykład obiekt, który zwraca polecenie cmdlet Get-SCManagementGroupConnection.
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
-Server
Określa serwer, który udostępnia kanały SMTP i IM dla powiadomień.
Właściwości parametru
Typ:
String
Domyślna wartość:
None
Obsługuje symbole wieloznaczne:
False
DontShow:
False
Zestawy parametrów
UsingSMTP
Position:
Named
Obowiązkowy:
True
Wartość z potoku:
False
Wartość z potoku według nazwy właściwości:
True
Wartość z pozostałych argumentów:
False
UsingSIP
Position:
Named
Obowiązkowy:
True
Wartość z potoku:
False
Wartość z potoku według nazwy właściwości:
True
Wartość z pozostałych argumentów:
False
-SipAuthentication
Określa mechanizm uwierzytelniania protokołu inicjowania sesji (SIP) (NTLM lub Kerberos) dla kanałów wiadomości błyskawicznych.
Domyślnie uwierzytelnianie SIP używa uwierzytelniania NTLM.
Właściwości parametru
Typ:
SipNotificationAuthenticationProtocols
Domyślna wartość:
None
Obsługuje symbole wieloznaczne:
False
DontShow:
False
Zestawy parametrów
UsingSIP
Position:
Named
Obowiązkowy:
False
Wartość z potoku:
False
Wartość z potoku według nazwy właściwości:
True
Wartość z pozostałych argumentów:
False
-SipProtocol
Określa protokół transportu SIP (TCP lub TLS) dla kanałów wiadomości błyskawicznych.
Domyślnie SIP używa protokołu TCP jako protokołu transportowego.
Właściwości parametru
Typ:
SipTransportProtocol
Domyślna wartość:
None
Obsługuje symbole wieloznaczne:
False
DontShow:
False
Zestawy parametrów
UsingSIP
Position:
Named
Obowiązkowy:
False
Wartość z potoku:
False
Wartość z potoku według nazwy właściwości:
True
Wartość z pozostałych argumentów:
False
-Sms
Wskazuje, że polecenie cmdlet wysyła powiadomienia przy użyciu wiadomości SMS.
Właściwości parametru
Typ:
SwitchParameter
Domyślna wartość:
None
Obsługuje symbole wieloznaczne:
False
DontShow:
False
Zestawy parametrów
UsingSMS
Position:
Named
Obowiązkowy:
True
Wartość z potoku:
False
Wartość z potoku według nazwy właściwości:
True
Wartość z pozostałych argumentów:
False
-Subject
Określa wiersz tematu dla wiadomości e-mail z powiadomieniem.
Właściwości parametru
Typ:
String
Domyślna wartość:
None
Obsługuje symbole wieloznaczne:
False
DontShow:
False
Zestawy parametrów
UsingSMTP
Position:
Named
Obowiązkowy:
False
Wartość z potoku:
False
Wartość z potoku według nazwy właściwości:
True
Wartość z pozostałych argumentów:
False
-UserName
Określa adres zwrotny wiadomości błyskawicznych.
Właściwości parametru
Typ:
Uri
Domyślna wartość:
None
Obsługuje symbole wieloznaczne:
False
DontShow:
False
Zestawy parametrów
UsingSIP
Position:
2
Obowiązkowy:
True
Wartość z potoku:
False
Wartość z potoku według nazwy właściwości:
True
Wartość z pozostałych argumentów:
False
-WhatIf
Pokazuje, co się stanie, jeśli polecenie cmdlet zostanie uruchomione.
Polecenie cmdlet nie jest uruchamiane.
Właściwości parametru
Typ:
SwitchParameter
Domyślna wartość:
False
Obsługuje symbole wieloznaczne:
False
DontShow:
False
Aliasy:
Wi
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
-WorkingDirectory
Określa katalog roboczy dla kanału poleceń.
Domyślnie kanał poleceń używa %systemdrive% jako katalogu roboczego.
Właściwości parametru
Typ:
String
Domyślna wartość:
None
Obsługuje symbole wieloznaczne:
False
DontShow:
False
Zestawy parametrów
CommandAction
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
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.