Add-SCOMNotificationChannel
Přidá kanál oznámení v Operations Manageru.
Syntaxe
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>] Description
Rutina Add-SCOMNotificationChannel přidá kanál oznámení v nástroji System Center – Operations Manager. Kanály oznámení informují správce o upozornění nebo spouští automatizaci v reakci na výstrahu. Kanál oznámení používá mechanismus doručování v Operations Manageru, jako je e-mail, zasílání rychlých zpráv, služba krátkých zpráv (SMS) nebo příkaz k doručování oznámení.
Příklady
Příklad 1: Přidání kanálu oznámení
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 $BodyTento příklad přidá standardní e-mailový kanál SMTP.
První příkaz uloží řádek předmětu do proměnné s názvem $Subject.
Druhý příkaz uloží text zprávy do proměnné s názvem $Body.
Třetí příkaz používá rutinu Add-SCOMNotificationChannel k přidání e-mailového kanálu SMTP.
Příklad 2: Přidání kanálu oznámení pro rychlé zprávy
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 $BodyTento příklad přidá kanál rychlých zpráv, který má zpáteční adresu scomadmin.
První příkaz uloží text zprávy do proměnné s názvem $Body.
Druhý příkaz používá rutinu Add-SCOMNotificationChannel k přidání kanálu rychlých zpráv.
Příklad 3: Přidání kanálu oznámení pro 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"Tento příklad přidá kanál SMS s kódováním Unicode.
První příkaz uloží text zprávy do proměnné s názvem $Body.
Druhý příkaz používá rutinu Add-SCOMNotificationChannel k přidání kanálu SMS.
Příklad 4: Přidání kanálu oznámení příkazu
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 $WorkingDirTento příklad přidá kanál oznámení příkazu, který spustí OnNotify.exe program.
První příkaz uloží cestu ke spustitelnému souboru do proměnné s názvem $Path.
Druhý příkaz uloží argumenty do proměnné s názvem $Arg.
Třetí příkaz uloží pracovní adresář do proměnné s názvem $WorkingDir.
Čtvrtý příkaz používá rutinu Add-SCOMNotificationChannel k přidání kanálu oznámení příkazu.
Parametry
-Anonymous
Označuje, že anonymní server SMTP (Simple Mail Transfer Protocol) odesílá e-mailová oznámení.
| Typ: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | True |
| Přijmout zástupné znaky: | False |
-ApplicationPath
Určuje cestu aplikace kanálu příkazu.
| Typ: | String |
| Position: | 1 |
| Default value: | None |
| Vyžadováno: | True |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-Argument
Určuje seznam argumentů pro kanál příkazů.
| Typ: | String |
| Position: | 2 |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-BackupDevice
Určuje pole sekundárních zařízení SMS.
| Typ: | String[] |
| Position: | 3 |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | True |
| Přijmout zástupné znaky: | False |
-BackupSmtpServer
Určuje pole zálohovaných serverů SMTP. Záložní servery používají stejnou konfiguraci jako primární server SMTP.
| Typ: | String[] |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | True |
| Přijmout zástupné znaky: | False |
-Body
Určuje text zprávy s oznámením.
| Typ: | String |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | True |
| Přijmout vstup kanálu: | True |
| Přijmout zástupné znaky: | False |
-BodyAsHtml
Označuje, že služba formátuje text zprávy jako HTML.
| Typ: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | True |
| Přijmout zástupné znaky: | False |
-ComputerName
Určuje pole názvů počítačů. Rutina vytvoří dočasná připojení ke skupinám pro správu pro tyto počítače. Můžete použít názvy NetBIOS, IP adresy nebo plně kvalifikované názvy domén (FQDN). Chcete-li zadat místní počítač, zadejte název počítače, localhost nebo tečku (.).
| Typ: | String[] |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-Confirm
Před spuštěním rutiny vás vyzve k potvrzení.
| Typ: | SwitchParameter |
| Aliasy: | cf |
| Position: | Named |
| Default value: | False |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-ContentType
Určuje typ obsahu rychlé zprávy.
Ve výchozím nastavení je typ obsahu text/plain.
| Typ: | String |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | True |
| Přijmout zástupné znaky: | False |
-Credential
Určuje objekt PSCredential pro připojení skupiny pro správu.
K získání objektu PSCredential použijte rutinu Get-Credential.
Další informace potřebujete zadáním "Get-Help Get-Credential".
Pokud zadáte počítač v parametru ComputerName, použijte účet, který má přístup k danému počítači. Výchozí hodnota je aktuální uživatel.
| Typ: | PSCredential |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-Description
Určuje popis kanálu oznámení. Pokud hodnotu nenastavíte, výchozí hodnota je hodnota parametru DisplayName.
| Typ: | String |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | True |
| Přijmout zástupné znaky: | False |
-Device
Určuje primární zařízení SMS.
| Typ: | String |
| Position: | 2 |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | True |
| Přijmout zástupné znaky: | False |
-DeviceEnumerationInterval
Určuje časový interval mezi oznámeními SMS. Ve výchozím nastavení kanál oznámení čeká 10 sekund.
| Typ: | TimeSpan |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | True |
| Přijmout zástupné znaky: | False |
-DisplayName
Určuje zobrazovaný název kanálu oznámení. Pokud hodnotu nenastavíte, výchozí hodnota je hodnota parametru Name.
| Typ: | String |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | True |
| Přijmout zástupné znaky: | False |
-Encoding
Určuje formát kódování pro zprávu s oznámením. Kanál SMTP ve výchozím nastavení používá kódování UTF-8. Kanál IM také ve výchozím nastavení používá kódování UTF-8. Kanál SMS používá ve výchozím nastavení výchozí kódování, ale může alternativně použít kódování Unicode.
| Typ: | String |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | True |
| Přijmout zástupné znaky: | False |
-ExternalEmail
Určuje, jestli se má použít externí e-mail.
| Typ: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | True |
| Přijmout zástupné znaky: | False |
-ExternalEmailRunasProfile
Určuje profil Spustit jako pro externí e-mail.
| Typ: | String |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | True |
| Přijmout zástupné znaky: | False |
-From
Určuje záhlaví Od v e-mailové zprávě s oznámením.
| Typ: | String |
| Position: | 2 |
| Default value: | None |
| Vyžadováno: | True |
| Přijmout vstup kanálu: | True |
| Přijmout zástupné znaky: | False |
-Header
Určuje hlavičky jako páry klíč-hodnota v e-mailové zprávě s oznámením.
| Typ: | Hashtable |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | True |
| Přijmout zástupné znaky: | False |
-MaxPrimaryRecipientsPerMail
Určuje maximální počet příjemců pro e-mailovou zprávu s oznámením.
| Typ: | Int32 |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | True |
| Přijmout zástupné znaky: | False |
-Name
Určuje název kanálu oznámení.
| Typ: | String |
| Position: | 1 |
| Default value: | None |
| Vyžadováno: | True |
| Přijmout vstup kanálu: | True |
| Přijmout zástupné znaky: | False |
-NoSubjectEncoding
Označuje, že rutina nekóduje řádek předmětu e-mailu.
| Typ: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | True |
| Přijmout zástupné znaky: | False |
-Port
Určuje číslo portu pro kanál.
Kanál SMTP ve výchozím nastavení používá port 25. Kanál rychlých zpráv, který používá protokol TCP, ve výchozím nastavení používá port 5060 a kanál rychlých zpráv, který používá protokol TLS (Transport Layer Security), ve výchozím nastavení používá port 5061.
| Typ: | UInt32 |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | True |
| Přijmout zástupné znaky: | False |
-PreferredUserName
Určuje upřednostňované uživatelské jméno kanálu rychlých zpráv. Pokud hodnotu nenastavíte, výchozí hodnota je hodnota parametru Username.
| Typ: | String |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | True |
| Přijmout zástupné znaky: | False |
-PrimaryRetryInterval
Určuje interval opakování. Služba se pokusí přepnout zpět na primární server SMTP nebo zařízení SMS. Ve výchozím nastavení je interval pět minut.
| Typ: | TimeSpan |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | True |
| Přijmout zástupné znaky: | False |
-ReplyTo
Určuje záhlaví odpovědi v e-mailové zprávě s oznámením.
| Typ: | String |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | True |
| Přijmout zástupné znaky: | False |
-SCSession
Určuje pole objektů Connection. K získání objektu Connection použijte rutinu Get-SCManagementGroupConnection.
Zadejte objekt připojení pro skupinu pro správu, například objekt, který Rutina Get-SCManagementGroupConnection vrátí.
| Typ: | Connection[] |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-Server
Určuje server, který poskytuje pro oznámení kanály SMTP a rychlých zpráv.
| Typ: | String |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | True |
| Přijmout vstup kanálu: | True |
| Přijmout zástupné znaky: | False |
-SipAuthentication
Určuje mechanismus ověřování protokolu SIP (Session Initiation Protocol) (NTLM nebo Kerberos) pro kanály rychlých zpráv. Ve výchozím nastavení ověřování SIP používá ověřování NTLM.
| Typ: | SipNotificationAuthenticationProtocols |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | True |
| Přijmout zástupné znaky: | False |
-SipProtocol
Určuje přenosový protokol SIP (TCP nebo TLS) pro kanály rychlých zpráv. Protokol SIP ve výchozím nastavení používá protokol TCP jako přenosový protokol.
| Typ: | SipTransportProtocol |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | True |
| Přijmout zástupné znaky: | False |
-Sms
Označuje, že rutina odesílá oznámení pomocí sms.
| Typ: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | True |
| Přijmout vstup kanálu: | True |
| Přijmout zástupné znaky: | False |
-Subject
Určuje řádek předmětu e-mailové zprávy s oznámením.
| Typ: | String |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | True |
| Přijmout zástupné znaky: | False |
-UserName
Určuje zpáteční adresu pro rychlé zprávy.
| Typ: | Uri |
| Position: | 2 |
| Default value: | None |
| Vyžadováno: | True |
| Přijmout vstup kanálu: | True |
| Přijmout zástupné znaky: | False |
-WhatIf
Ukazuje, co se stane, když se rutina spustí. Rutina se nespustí.
| Typ: | SwitchParameter |
| Aliasy: | wi |
| Position: | Named |
| Default value: | False |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-WorkingDirectory
Určuje pracovní adresář pro kanál příkazů. Ve výchozím nastavení kanál příkazů používá %systemdrive% jako pracovní adresář.
| Typ: | String |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |