Add-SCOMNotificationChannel
Dodaje kanał powiadomień w programie Operations Manager.
Składnia
Add-SCOMNotificationChannel
[-Name] <String>
[-Port <UInt32>]
[-DisplayName <String>]
[-Description <String>]
-Server <String>
[-From] <String>
[-ReplyTo <String>]
[-Header <Hashtable>]
[-Anonymous]
[-ExternalEmail]
[-ExternalEmailRunasProfile <String>]
[-BackupSmtpServer <String[]>]
[-MaxPrimaryRecipientsPerMail <Int32>]
[-PrimaryRetryInterval <TimeSpan>]
[-Subject <String>]
-Body <String>
[-BodyAsHtml]
[-Encoding <String>]
[-NoSubjectEncoding]
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Add-SCOMNotificationChannel
[-Name] <String>
[-Port <UInt32>]
[-DisplayName <String>]
[-Description <String>]
[-UserName] <Uri>
[-ContentType <String>]
-Server <String>
[-SipProtocol <SipTransportProtocol>]
[-SipAuthentication <SipNotificationAuthenticationProtocols>]
[-PreferredUserName <String>]
-Body <String>
[-Encoding <String>]
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Add-SCOMNotificationChannel
[-Name] <String>
[-DisplayName <String>]
[-Description <String>]
[-ApplicationPath] <String>
[[-Argument] <String>]
[-WorkingDirectory <String>]
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Add-SCOMNotificationChannel
[-Name] <String>
[-DisplayName <String>]
[-Description <String>]
[-PrimaryRetryInterval <TimeSpan>]
[-DeviceEnumerationInterval <TimeSpan>]
[-Sms]
[[-Device] <String>]
[[-BackupDevice] <String[]>]
-Body <String>
[-Encoding <String>]
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Opis
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.
Przykłady
Przykład 1. Dodawanie kanału powiadomień
PS C:\>$Subject = "SCOM alert `$Data[Default='Not Present']/Context/DataItem/AlertName`$"
PS C:\> $Body = "Owner is `$Data[Default='Not Present']/Context/DataItem/AlertOwner`$"
PS C:\> Add-SCOMNotificationChannel -Name "Contoso.Email" -Server "mail.contoso.com" -From "scom@contoso.net" -Subject $Subject -Body $BodyW tym przykładzie dodano standardowy kanał poczty e-mail SMTP.
Pierwsze polecenie przechowuje wiersz tematu w zmiennej o nazwie $Subject.
Drugie polecenie przechowuje treść komunikatu w zmiennej o nazwie $Body.
Trzecie polecenie używa polecenia cmdlet Add-SCOMNotificationChannel w celu dodania kanału poczty e-mail SMTP.
Przykład 2. Dodawanie kanału powiadomień dla wiadomości błyskawicznych
PS C:\>$Body = "SCOM alert `$Data[Default='Not Present']/Context/DataItem/AlertName`$"
PS C:\> Add-SCOMNotificationChannel -Name "Contoso.IM" -Server "sipserver.contoso.com" -UserName 'sip:scomadmin' -Body $BodyW tym przykładzie dodano kanał wiadomości błyskawicznych z adresem zwrotnym scomadmin.
Pierwsze polecenie przechowuje treść komunikatu w zmiennej o nazwie $Body.
Drugie polecenie używa polecenia cmdlet Add-SCOMNotificationChannel w celu dodania kanału wiadomości błyskawicznych.
Przykład 3. Dodawanie kanału powiadomień dla wiadomości SMS
PS C:\>$Body = "SCOM alert `$Data[Default='Not Present']/Context/DataItem/AlertName`$"
PS C:\> Add-SCOMNotificationChannel -Sms -Name "Contoso.SMS" -Body $Body -Encoding "Unicode"W tym przykładzie dodano kanał SMS z kodowaniem Unicode.
Pierwsze polecenie przechowuje treść komunikatu w zmiennej o nazwie $Body.
Drugie polecenie używa polecenia cmdlet Add-SCOMNotificationChannel w celu dodania kanału SMS.
Przykład 4. Dodawanie kanału powiadomień polecenia
PS C:\>$Path = "C:\OnNotify.exe"
PS C:\> $Arg = "/notify /owner `"`$Data[Default='Not Present']/Context/DataItem/AlertOwner`$`""
PS C:\> $WorkingDir = "C:\"
PS C:\> Add-SCOMNotificationChannel -Name "Contoso.Command" -ApplicationPath $Path -Argument $Arg -WorkingDirectory $WorkingDirW 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.
| Typ: | SwitchParameter |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | False |
-ApplicationPath
Określa ścieżkę aplikacji kanału poleceń.
| Typ: | String |
| Position: | 1 |
| Domyślna wartość: | None |
| Wymagane: | True |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-Argument
Określa listę argumentów do kanału poleceń.
| Typ: | String |
| Position: | 2 |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-BackupDevice
Określa tablicę pomocniczych urządzeń SMS.
| Typ: | String[] |
| Position: | 3 |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | False |
-BackupSmtpServer
Określa tablicę serwerów SMTP kopii zapasowych. Serwery kopii zapasowych używają tej samej konfiguracji co podstawowy serwer SMTP.
| Typ: | String[] |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | False |
-Body
Określa treść wiadomości z powiadomieniem.
| Typ: | String |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | True |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | False |
-BodyAsHtml
Wskazuje, że usługa formatuje treść komunikatu jako HTML.
| Typ: | SwitchParameter |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | 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ę (.).
| Typ: | String[] |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-Confirm
Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.
| Typ: | SwitchParameter |
| Aliasy: | cf |
| Position: | Named |
| Domyślna wartość: | False |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-ContentType
Określa typ zawartości wiadomości błyskawicznej.
Domyślnie typ zawartości to text/plain.
| Typ: | String |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | 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.
| Typ: | PSCredential |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-Description
Określa opis kanału powiadomień. Jeśli nie ustawisz wartości, wartość domyślna to wartość parametru DisplayName.
| Typ: | String |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | False |
-Device
Określa podstawowe urządzenie SMS.
| Typ: | String |
| Position: | 2 |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | False |
-DeviceEnumerationInterval
Określa przedział czasu między powiadomieniami SMS. Domyślnie kanał powiadomień czeka 10 sekund.
| Typ: | TimeSpan |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | False |
-DisplayName
Określa nazwę wyświetlaną kanału powiadomień. Jeśli nie ustawisz wartości, wartość domyślna to wartość parametru Name.
| Typ: | String |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | 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.
| Typ: | String |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | False |
-ExternalEmail
Określa, czy używać zewnętrznej poczty e-mail.
| Typ: | SwitchParameter |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | False |
-ExternalEmailRunasProfile
Określa profil Uruchom jako dla zewnętrznej poczty e-mail.
| Typ: | String |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | False |
-From
Określa nagłówek From w wiadomości e-mail z powiadomieniem.
| Typ: | String |
| Position: | 2 |
| Domyślna wartość: | None |
| Wymagane: | True |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | False |
-Header
Określa nagłówki jako pary klucz-wartość w wiadomości e-mail z powiadomieniem.
| Typ: | Hashtable |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | False |
-MaxPrimaryRecipientsPerMail
Określa maksymalną liczbę adresatów wiadomości e-mail z powiadomieniem.
| Typ: | Int32 |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | False |
-Name
Określa nazwę kanału powiadomień.
| Typ: | String |
| Position: | 1 |
| Domyślna wartość: | None |
| Wymagane: | True |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | False |
-NoSubjectEncoding
Wskazuje, że polecenie cmdlet nie koduje wiersza tematu wiadomości e-mail.
| Typ: | SwitchParameter |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | 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.
| Typ: | UInt32 |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | 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.
| Typ: | String |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | 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.
| Typ: | TimeSpan |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | False |
-ReplyTo
Określa nagłówek Reply-to w wiadomości e-mail z powiadomieniem.
| Typ: | String |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | False |
-SCSession
Określa tablicę obiektów połączenia
Wprowadź obiekt połączenia dla grupy zarządzania, na przykład obiekt, który zwraca polecenie cmdlet Get-SCManagementGroupConnection.
| Typ: | Connection[] |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-Server
Określa serwer, który udostępnia kanały SMTP i IM dla powiadomień.
| Typ: | String |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | True |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | 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.
| Typ: | SipNotificationAuthenticationProtocols |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | 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.
| Typ: | SipTransportProtocol |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | False |
-Sms
Wskazuje, że polecenie cmdlet wysyła powiadomienia przy użyciu wiadomości SMS.
| Typ: | SwitchParameter |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | True |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | False |
-Subject
Określa wiersz tematu dla wiadomości e-mail z powiadomieniem.
| Typ: | String |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | False |
-UserName
Określa adres zwrotny wiadomości błyskawicznych.
| Typ: | Uri |
| Position: | 2 |
| Domyślna wartość: | None |
| Wymagane: | True |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | False |
-WhatIf
Pokazuje, co się stanie, jeśli polecenie cmdlet zostanie uruchomione. Polecenie cmdlet nie jest uruchamiane.
| Typ: | SwitchParameter |
| Aliasy: | wi |
| Position: | Named |
| Domyślna wartość: | False |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-WorkingDirectory
Określa katalog roboczy dla kanału poleceń. Domyślnie kanał poleceń używa %systemdrive% jako katalogu roboczego.
| Typ: | String |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |