Udostępnij za pośrednictwem

Add-SCOMNotificationChannel

  • Odwołanie
Moduł:
OperationsManager

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 $Body

W 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 $Body

W 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 , aby dodać kanał 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ń poleceń

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 $WorkingDir

W tym przykładzie dodano kanał powiadomień poleceń, który uruchamia program 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ń poleceń.

Parametry

-Anonymous

Wskazuje, że anonimowy serwer protokołu Simple Mail Transfer Protocol (SMTP) wysyła powiadomienia e-mail.

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

-ApplicationPath

Określa ścieżkę aplikacji kanału poleceń.

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Argument

Określa listę argumentów do kanału poleceń.

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

-BackupDevice

Określa tablicę pomocniczych urządzeń SMS.

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

-BackupSmtpServer

Określa tablicę kopii zapasowych serwerów SMTP. Serwery kopii zapasowych używają tej samej konfiguracji co podstawowy serwer SMTP.

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

-Body

Określa treść komunikatu powiadomienia.

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

-BodyAsHtml

Wskazuje, że usługa formatuje treść komunikatu jako HTML.

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

-ComputerName

Określa tablicę nazw komputerów. Polecenie cmdlet ustanawia tymczasowe połączenia z grupami zarządzania dla tych 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ę (.).

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

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ContentType

Określa typ zawartości wiadomości błyskawicznej. Domyślnie typ zawartości to text/plain.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
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 "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

-Description

Określa opis kanału powiadomień. Jeśli nie ustawisz wartości, wartość domyślna to wartość parametru DisplayName .

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

-Device

Określa podstawowe urządzenie SMS.

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

-DeviceEnumerationInterval

Określa interwał czasu między powiadomieniami SMS. Domyślnie kanał powiadomień czeka 10 sekund.

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

-DisplayName

Określa nazwę wyświetlaną kanału powiadomień. Jeśli nie ustawisz wartości, wartość domyślna to wartość parametru Name .

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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.

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

-ExternalEmail

Określa, czy używać zewnętrznej poczty e-mail.

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

-ExternalEmailRunasProfile

Określa profil Uruchom jako dla zewnętrznej poczty e-mail.

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

-From

Określa nagłówek From w wiadomości e-mail z powiadomieniem.

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

-Header

Określa nagłówki jako pary klucz-wartość w wiadomości e-mail z powiadomieniem.

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

-MaxPrimaryRecipientsPerMail

Określa maksymalną liczbę adresatów wiadomości e-mail z powiadomieniem.

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

-Name

Określa nazwę kanału powiadomień.

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-NoSubjectEncoding

Wskazuje, że polecenie cmdlet nie koduje wiersza tematu wiadomości e-mail.

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

-Port

Określa numer portu kanału.

Kanał SMTP domyślnie używa portu 25. Kanał wiadomości błyskawicznych używający 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.

Type:UInt32
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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 Nazwa użytkownika .

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

-PrimaryRetryInterval

Określa interwał ponawiania prób. Usługa próbuje wrócić do podstawowego serwera SMTP lub urządzenia SMS. Domyślnie interwał wynosi pięć minut.

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

-ReplyTo

Określa nagłówek Odpowiedz do w wiadomości e-mail z powiadomieniem.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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, taki jak obiekt cmdlet Get-SCManagementGroupConnection .

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

-Server

Określa serwer, który udostępnia kanały SMTP i IM na potrzeby powiadomień.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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.

Type:SipNotificationAuthenticationProtocols
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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.

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

-Sms

Wskazuje, że polecenie cmdlet wysyła powiadomienia przy użyciu wiadomości SMS.

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

-Subject

Określa wiersz tematu dla wiadomości e-mail z powiadomieniem.

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

-UserName

Określa adres zwrotny wiadomości błyskawicznych.

Type:Uri
Position:2
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

Pokazuje, co się stanie po uruchomieniu polecenia cmdlet. Polecenie cmdlet nie zostało uruchomione.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WorkingDirectory

Określa katalog roboczy kanału poleceń. Domyślnie kanał poleceń używa %systemdrive% jako katalogu roboczego.

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