Add-SCOMNotificationChannel
Fügt einen Benachrichtigungskanal in Operations Manager hinzu.
Syntax
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>] Beschreibung
Das Cmdlet Add-SCOMNotificationChannel fügt einen Benachrichtigungskanal in System Center – Operations Manager hinzu. Benachrichtigungskanäle informieren Administratoren über eine Warnung, oder sie führen eine Automatisierung als Reaktion auf eine Warnung aus. Ein Benachrichtigungskanal verwendet einen Übermittlungsmechanismus in Operations Manager, z. B. E-Mail, Chat, Kurznachrichtendienst (SMS) oder Befehl, um Benachrichtigungen zu übermitteln.
Beispiele
Beispiel 1: Hinzufügen eines Benachrichtigungskanals
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 $BodyIn diesem Beispiel wird ein SMTP-Standard-E-Mail-Kanal hinzugefügt.
Der erste Befehl speichert die Betreffzeile in der Variablen mit dem Namen $Subject.
Der zweite Befehl speichert den Nachrichtentext in der Variablen mit dem Namen $Body.
Der dritte Befehl verwendet das Cmdlet Add-SCOMNotificationChannel , um einen SMTP-E-Mail-Kanal hinzuzufügen.
Beispiel 2: Hinzufügen eines Benachrichtigungskanals für Chatnachrichten
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 $BodyIn diesem Beispiel wird ein Chatkanal hinzugefügt, der über die Rückgabeadresse scomadmin verfügt.
Der erste Befehl speichert den Nachrichtentext in der Variablen mit dem Namen $Body.
Der zweite Befehl verwendet das Cmdlet Add-SCOMNotificationChannel , um einen Chatkanal hinzuzufügen.
Beispiel 3: Hinzufügen eines Benachrichtigungskanals für 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"In diesem Beispiel wird ein SMS-Kanal mit Unicode-Codierung hinzugefügt.
Der erste Befehl speichert den Nachrichtentext in der Variablen mit dem Namen $Body.
Der zweite Befehl verwendet das Cmdlet Add-SCOMNotificationChannel , um einen SMS-Kanal hinzuzufügen.
Beispiel 4: Hinzufügen eines Befehlsbenachrichtigungskanals
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 $WorkingDirIn diesem Beispiel wird ein Befehlsbenachrichtigungskanal hinzugefügt, über den das programm OnNotify.exe ausgeführt wird.
Der erste Befehl speichert den Pfad zur ausführbaren Datei in der Variablen namens $Path.
Der zweite Befehl speichert die Argumente in der Variablen namens $Arg.
Der dritte Befehl speichert das Arbeitsverzeichnis in der Variablen mit dem Namen $WorkingDir.
Der vierte Befehl verwendet das Cmdlet Add-SCOMNotificationChannel , um einen Befehlsbenachrichtigungskanal hinzuzufügen.
Parameter
-Anonymous
Gibt an, dass ein anonymer SMTP-Server (Simple Mail Transfer Protocol) E-Mail-Benachrichtigungen sendet.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ApplicationPath
Gibt den Anwendungspfad eines Befehlskanals an.
| Type: | String |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Argument
Gibt eine Argumentliste für einen Befehlskanal an.
| Type: | String |
| Position: | 2 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-BackupDevice
Gibt ein Array sekundärer SMS-Geräte an.
| Type: | String[] |
| Position: | 3 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-BackupSmtpServer
Gibt ein Array von SMTP-Sicherungsservern an. Sicherungsserver verwenden dieselbe Konfiguration wie der primäre SMTP-Server.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Body
Gibt den Text einer Benachrichtigung an.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-BodyAsHtml
Gibt an, dass der Dienst den Nachrichtentext als HTML formatiert.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ComputerName
Gibt ein Array von Namen von Computern an. Das Cmdlet stellt temporäre Verbindungen mit Verwaltungsgruppen für diese Computer her. Sie können NetBIOS-Namen, IP-Adressen oder vollqualifizierte Domänennamen (FQDNs) verwenden. Um den lokalen Computer anzugeben, geben Sie den Computernamen, localhost oder einen Punkt (.) ein.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Confirm
Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ContentType
Gibt den Inhaltstyp einer Chatnachricht an.
Standardmäßig ist text/plainder Inhaltstyp .
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Credential
Gibt ein PSCredential-Objekt für die Verwaltungsgruppenverbindung an.
Verwenden Sie zum Abrufen eines PSCredential-Objekts das Get-Credential-Cmdlet.
Um weitere Informationen zu erfahren, geben Sie "Get-Help Get-Credential" ein.
Wenn Sie einen Computer im ComputerName-Parameter angeben, verwenden Sie ein Konto, das Zugriff auf diesen Computer hat. Der Standardwert ist der aktuelle Benutzer.
| Type: | PSCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Description
Gibt eine Beschreibung für einen Benachrichtigungskanal an. Wenn Sie keinen Wert festlegen, ist der Standardwert der Wert des DisplayName-Parameters .
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Device
Gibt ein primäres SMS-Gerät an.
| Type: | String |
| Position: | 2 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-DeviceEnumerationInterval
Gibt ein Zeitintervall zwischen SMS-Benachrichtigungen an. Standardmäßig wartet der Benachrichtigungskanal 10 Sekunden.
| Type: | TimeSpan |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-DisplayName
Gibt einen Anzeigenamen für einen Benachrichtigungskanal an. Wenn Sie keinen Wert festlegen, ist der Standardwert der Wert des Parameters Name .
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Encoding
Gibt das Codierungsformat für eine Benachrichtigung an. Ein SMTP-Kanal verwendet standardmäßig UTF-8-Codierung. Ein Chatkanal verwendet standardmäßig auch UTF-8-Codierung. Ein SMS-Kanal verwendet standardmäßig die Standardcodierung, kann aber alternativ unicode-Codierung verwenden.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ExternalEmail
Gibt an, ob externe E-Mails verwendet werden sollen.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ExternalEmailRunasProfile
Gibt das Profil Ausführen als für externe E-Mails an.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-From
Gibt den Von-Header in einer Benachrichtigungs-E-Mail an.
| Type: | String |
| Position: | 2 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Header
Gibt Header als Schlüssel-Wert-Paare in einer Benachrichtigungs-E-Mail an.
| Type: | Hashtable |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-MaxPrimaryRecipientsPerMail
Gibt die maximale Anzahl von Empfängern für eine Benachrichtigungs-E-Mail an.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Name
Gibt den Namen eines Benachrichtigungskanals an.
| Type: | String |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-NoSubjectEncoding
Gibt an, dass das Cmdlet die Betreffzeile der E-Mail nicht codiert.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Port
Gibt die Portnummer für einen Kanal an.
Ein SMTP-Kanal verwendet standardmäßig Port 25. Ein Chatkanal, der TCP verwendet, verwendet standardmäßig Port 5060, und ein Chatkanal, der TLS (Transport Layer Security) verwendet, verwendet standardmäßig Port 5061.
| Type: | UInt32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-PreferredUserName
Gibt den bevorzugten Benutzernamen eines Chatkanals an. Wenn Sie keinen Wert festlegen, ist der Standardwert der Wert des Username-Parameters .
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-PrimaryRetryInterval
Gibt ein Wiederholungsintervall an. Der Dienst versucht, zurück zum primären SMTP-Server oder SMS-Gerät zu wechseln. Standardmäßig beträgt das Intervall fünf Minuten.
| Type: | TimeSpan |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ReplyTo
Gibt den Antwort-an-Header in einer Benachrichtigungs-E-Mail an.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-SCSession
Gibt ein Array von Connection-Objekten an. Verwenden Sie zum Abrufen eines Connection-Objekts das Cmdlet Get-SCManagementGroupConnection .
Geben Sie ein Verbindungsobjekt für eine Verwaltungsgruppe ein, z. B. eines, das vom Cmdlet Get-SCManagementGroupConnection zurückgegeben wird.
| Type: | Connection[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Server
Gibt einen Server an, der SMTP- und Chatkanäle für Benachrichtigungen bereitstellt.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-SipAuthentication
Gibt einen SIP-Authentifizierungsmechanismus (Session Initiation Protocol) (NTLM oder Kerberos) für Chatkanäle an. Standardmäßig verwendet die SIP-Authentifizierung die NTLM-Authentifizierung.
| Type: | SipNotificationAuthenticationProtocols |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-SipProtocol
Gibt ein SIP-Transportprotokoll (TCP oder TLS) für Chatkanäle an. Standardmäßig verwendet SIP TCP als Transportprotokoll.
| Type: | SipTransportProtocol |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Sms
Gibt an, dass das Cmdlet Benachrichtigungen mithilfe von SMS sendet.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Subject
Gibt eine Betreffzeile für die Benachrichtigungs-E-Mail an.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-UserName
Gibt eine Rückgabeadresse für Chatnachrichten an.
| Type: | Uri |
| Position: | 2 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-WhatIf
Zeigt, was geschieht, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-WorkingDirectory
Gibt ein Arbeitsverzeichnis für einen Befehlskanal an. Standardmäßig verwendet ein Befehlskanal %systemdrive% als Arbeitsverzeichnis.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |