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 die Automatisierung als Reaktion auf eine Warnung durch.
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
In diesem Beispiel wird ein Befehlsbenachrichtigungskanal hinzugefügt, der das OnNotify.exe Programm ausführt.
Der erste Befehl speichert den Pfad zur ausführbaren Datei in der Variablen $Path.
Der zweite Befehl speichert die Argumente in der Variablen mit dem Namen $Arg.
Der dritte Befehl speichert das Arbeitsverzeichnis in der Variablen $WorkingDir.
Im vierten Befehl wird das Cmdlet Add-SCOMNotificationChannel verwendet, um einen Befehlsbenachrichtigungskanal hinzuzufügen.
Parameter
-Anonymous
Gibt an, dass ein anonymer SMTP-Server (Simple Mail Transfer Protocol) E-Mail-Benachrichtigungen sendet.
Parametereigenschaften
Typ:
SwitchParameter
Standardwert:
None
Unterstützt Platzhalter:
False
Nicht anzeigen:
False
Parametersätze
UsingSMTP
Position:
Named
Obligatorisch.:
False
Wert aus Pipeline:
False
Wert aus Pipeline nach dem Eigenschaftsnamen:
True
Wert aus verbleibenden Argumenten:
False
-ApplicationPath
Gibt den Anwendungspfad eines Befehlskanals an.
Parametereigenschaften
Typ:
String
Standardwert:
None
Unterstützt Platzhalter:
False
Nicht anzeigen:
False
Parametersätze
CommandAction
Position:
1
Obligatorisch.:
True
Wert aus Pipeline:
False
Wert aus Pipeline nach dem Eigenschaftsnamen:
False
Wert aus verbleibenden Argumenten:
False
-Argument
Gibt eine Argumentliste für einen Befehlskanal an.
Parametereigenschaften
Typ:
String
Standardwert:
None
Unterstützt Platzhalter:
False
Nicht anzeigen:
False
Parametersätze
CommandAction
Position:
2
Obligatorisch.:
False
Wert aus Pipeline:
False
Wert aus Pipeline nach dem Eigenschaftsnamen:
False
Wert aus verbleibenden Argumenten:
False
-BackupDevice
Gibt ein Array von sekundären SMS-Geräten an.
Parametereigenschaften
Typ:
String[]
Standardwert:
None
Unterstützt Platzhalter:
False
Nicht anzeigen:
False
Parametersätze
UsingSMS
Position:
3
Obligatorisch.:
False
Wert aus Pipeline:
False
Wert aus Pipeline nach dem Eigenschaftsnamen:
True
Wert aus verbleibenden Argumenten:
False
-BackupSmtpServer
Gibt ein Array von SMTP-Sicherungsservern an.
Sicherungsserver verwenden die gleiche Konfiguration wie der primäre SMTP-Server.
Parametereigenschaften
Typ:
String[]
Standardwert:
None
Unterstützt Platzhalter:
False
Nicht anzeigen:
False
Parametersätze
UsingSMTP
Position:
Named
Obligatorisch.:
False
Wert aus Pipeline:
False
Wert aus Pipeline nach dem Eigenschaftsnamen:
True
Wert aus verbleibenden Argumenten:
False
-Body
Gibt den Text einer Benachrichtigung an.
Parametereigenschaften
Typ:
String
Standardwert:
None
Unterstützt Platzhalter:
False
Nicht anzeigen:
False
Parametersätze
UsingSMTP
Position:
Named
Obligatorisch.:
True
Wert aus Pipeline:
False
Wert aus Pipeline nach dem Eigenschaftsnamen:
True
Wert aus verbleibenden Argumenten:
False
UsingSIP
Position:
Named
Obligatorisch.:
True
Wert aus Pipeline:
False
Wert aus Pipeline nach dem Eigenschaftsnamen:
True
Wert aus verbleibenden Argumenten:
False
UsingSMS
Position:
Named
Obligatorisch.:
True
Wert aus Pipeline:
False
Wert aus Pipeline nach dem Eigenschaftsnamen:
True
Wert aus verbleibenden Argumenten:
False
-BodyAsHtml
Gibt an, dass der Dienst den Text der Nachricht als HTML formatiert.
Parametereigenschaften
Typ:
SwitchParameter
Standardwert:
None
Unterstützt Platzhalter:
False
Nicht anzeigen:
False
Parametersätze
UsingSMTP
Position:
Named
Obligatorisch.:
False
Wert aus Pipeline:
False
Wert aus Pipeline nach dem Eigenschaftsnamen:
True
Wert aus verbleibenden Argumenten:
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 (Fully Qualified Domain Names, FQDNs) verwenden.
Um den lokalen Computer anzugeben, geben Sie den Computernamen, den Localhost oder einen Punkt (.) ein.
Parametereigenschaften
Typ:
String[]
Standardwert:
None
Unterstützt Platzhalter:
False
Nicht anzeigen:
False
Parametersätze
(All)
Position:
Named
Obligatorisch.:
False
Wert aus Pipeline:
False
Wert aus Pipeline nach dem Eigenschaftsnamen:
False
Wert aus verbleibenden Argumenten:
False
-Confirm
Fordert Sie zur Bestätigung auf, bevor Sie das Cmdlet ausführen.
Parametereigenschaften
Typ:
SwitchParameter
Standardwert:
False
Unterstützt Platzhalter:
False
Nicht anzeigen:
False
Aliase:
vgl
Parametersätze
(All)
Position:
Named
Obligatorisch.:
False
Wert aus Pipeline:
False
Wert aus Pipeline nach dem Eigenschaftsnamen:
False
Wert aus verbleibenden Argumenten:
False
-ContentType
Gibt den Inhaltstyp einer Chatnachricht an.
Standardmäßig ist text/plainder Inhaltstyp .
Parametereigenschaften
Typ:
String
Standardwert:
None
Unterstützt Platzhalter:
False
Nicht anzeigen:
False
Parametersätze
UsingSIP
Position:
Named
Obligatorisch.:
False
Wert aus Pipeline:
False
Wert aus Pipeline nach dem Eigenschaftsnamen:
True
Wert aus verbleibenden Argumenten:
False
-Credential
Gibt ein PSCredential- -Objekt für die Verwaltungsgruppenverbindung an.
Verwenden Sie das Cmdlet Get-Credential, um ein PSCredential-Objekt abzurufen.
Für weitere Informationen geben Sie "Get-Help Get-Credential" ein.
Wenn Sie im Parameter ComputerName einen Computer angeben, verwenden Sie ein Konto, das Zugriff auf diesen Computer hat.
Die Standardeinstellung ist der aktuelle Benutzer.
Parametereigenschaften
Typ:
PSCredential
Standardwert:
None
Unterstützt Platzhalter:
False
Nicht anzeigen:
False
Parametersätze
(All)
Position:
Named
Obligatorisch.:
False
Wert aus Pipeline:
False
Wert aus Pipeline nach dem Eigenschaftsnamen:
False
Wert aus verbleibenden Argumenten:
False
-Description
Gibt eine Beschreibung für einen Benachrichtigungskanal an.
Wenn Sie keinen Wert festlegen, ist der Standardwert der Wert des Parameters DisplayName .
Parametereigenschaften
Typ:
String
Standardwert:
None
Unterstützt Platzhalter:
False
Nicht anzeigen:
False
Parametersätze
(All)
Position:
Named
Obligatorisch.:
False
Wert aus Pipeline:
False
Wert aus Pipeline nach dem Eigenschaftsnamen:
True
Wert aus verbleibenden Argumenten:
False
-Device
Gibt ein primäres SMS-Gerät an.
Parametereigenschaften
Typ:
String
Standardwert:
None
Unterstützt Platzhalter:
False
Nicht anzeigen:
False
Parametersätze
UsingSMS
Position:
2
Obligatorisch.:
False
Wert aus Pipeline:
False
Wert aus Pipeline nach dem Eigenschaftsnamen:
True
Wert aus verbleibenden Argumenten:
False
-DeviceEnumerationInterval
Gibt ein Zeitintervall zwischen SMS-Benachrichtigungen an.
Standardmäßig wartet der Benachrichtigungskanal 10 Sekunden.
Parametereigenschaften
Typ:
TimeSpan
Standardwert:
None
Unterstützt Platzhalter:
False
Nicht anzeigen:
False
Parametersätze
UsingSMS
Position:
Named
Obligatorisch.:
False
Wert aus Pipeline:
False
Wert aus Pipeline nach dem Eigenschaftsnamen:
True
Wert aus verbleibenden Argumenten:
False
-DisplayName
Gibt einen Anzeigenamen für einen Benachrichtigungskanal an.
Wenn Sie keinen Wert festlegen, ist der Standardwert der Wert des Parameters Name .
Parametereigenschaften
Typ:
String
Standardwert:
None
Unterstützt Platzhalter:
False
Nicht anzeigen:
False
Parametersätze
(All)
Position:
Named
Obligatorisch.:
False
Wert aus Pipeline:
False
Wert aus Pipeline nach dem Eigenschaftsnamen:
True
Wert aus verbleibenden Argumenten:
False
-Encoding
Gibt das Codierungsformat für eine Benachrichtigung an.
Ein SMTP-Kanal verwendet standardmäßig die UTF-8-Codierung.
Ein Chatkanal verwendet standardmäßig auch die UTF-8-Codierung.
Ein SMS-Kanal verwendet standardmäßig die Standardcodierung, kann aber auch die Unicode-Codierung verwenden.
Parametereigenschaften
Typ:
String
Standardwert:
None
Unterstützt Platzhalter:
False
Nicht anzeigen:
False
Parametersätze
UsingSMTP
Position:
Named
Obligatorisch.:
False
Wert aus Pipeline:
False
Wert aus Pipeline nach dem Eigenschaftsnamen:
True
Wert aus verbleibenden Argumenten:
False
UsingSIP
Position:
Named
Obligatorisch.:
False
Wert aus Pipeline:
False
Wert aus Pipeline nach dem Eigenschaftsnamen:
True
Wert aus verbleibenden Argumenten:
False
UsingSMS
Position:
Named
Obligatorisch.:
False
Wert aus Pipeline:
False
Wert aus Pipeline nach dem Eigenschaftsnamen:
True
Wert aus verbleibenden Argumenten:
False
-ExternalEmail
Gibt an, ob externe E-Mail verwendet werden soll.
Parametereigenschaften
Typ:
SwitchParameter
Standardwert:
None
Unterstützt Platzhalter:
False
Nicht anzeigen:
False
Parametersätze
UsingSMTP
Position:
Named
Obligatorisch.:
False
Wert aus Pipeline:
False
Wert aus Pipeline nach dem Eigenschaftsnamen:
True
Wert aus verbleibenden Argumenten:
False
-ExternalEmailRunasProfile
Gibt das ausführende Profil für externe E-Mails an.
Parametereigenschaften
Typ:
String
Standardwert:
None
Unterstützt Platzhalter:
False
Nicht anzeigen:
False
Parametersätze
UsingSMTP
Position:
Named
Obligatorisch.:
False
Wert aus Pipeline:
False
Wert aus Pipeline nach dem Eigenschaftsnamen:
True
Wert aus verbleibenden Argumenten:
False
-From
Gibt den From-Header in einer Benachrichtigungs-E-Mail-Nachricht an.
Parametereigenschaften
Typ:
String
Standardwert:
None
Unterstützt Platzhalter:
False
Nicht anzeigen:
False
Parametersätze
UsingSMTP
Position:
2
Obligatorisch.:
True
Wert aus Pipeline:
False
Wert aus Pipeline nach dem Eigenschaftsnamen:
True
Wert aus verbleibenden Argumenten:
False
-Header
Gibt Kopfzeilen als Schlüssel-Wert-Paare in einer Benachrichtigungs-E-Mail an.
Parametereigenschaften
Typ:
Hashtable
Standardwert:
None
Unterstützt Platzhalter:
False
Nicht anzeigen:
False
Parametersätze
UsingSMTP
Position:
Named
Obligatorisch.:
False
Wert aus Pipeline:
False
Wert aus Pipeline nach dem Eigenschaftsnamen:
True
Wert aus verbleibenden Argumenten:
False
-MaxPrimaryRecipientsPerMail
Gibt die maximale Anzahl von Empfängern für eine Benachrichtigungs-E-Mail an.
Parametereigenschaften
Typ:
Int32
Standardwert:
None
Unterstützt Platzhalter:
False
Nicht anzeigen:
False
Parametersätze
UsingSMTP
Position:
Named
Obligatorisch.:
False
Wert aus Pipeline:
False
Wert aus Pipeline nach dem Eigenschaftsnamen:
True
Wert aus verbleibenden Argumenten:
False
-Name
Gibt den Namen eines Benachrichtigungskanals an.
Parametereigenschaften
Typ:
String
Standardwert:
None
Unterstützt Platzhalter:
False
Nicht anzeigen:
False
Parametersätze
(All)
Position:
1
Obligatorisch.:
True
Wert aus Pipeline:
False
Wert aus Pipeline nach dem Eigenschaftsnamen:
True
Wert aus verbleibenden Argumenten:
False
-NoSubjectEncoding
Gibt an, dass das Cmdlet die Betreffzeile der E-Mail nicht codiert.
Parametereigenschaften
Typ:
SwitchParameter
Standardwert:
None
Unterstützt Platzhalter:
False
Nicht anzeigen:
False
Parametersätze
UsingSMTP
Position:
Named
Obligatorisch.:
False
Wert aus Pipeline:
False
Wert aus Pipeline nach dem Eigenschaftsnamen:
True
Wert aus verbleibenden Argumenten:
False
-Port
Gibt die Portnummer für einen Kanal an.
Ein SMTP-Kanal verwendet standardmäßig Port 25.
Ein Chat-Kanal, der TCP verwendet, verwendet standardmäßig Port 5060, und ein IM-Kanal, der Transport Layer Security (TLS) verwendet, verwendet standardmäßig Port 5061.
Parametereigenschaften
Typ:
UInt32
Standardwert:
None
Unterstützt Platzhalter:
False
Nicht anzeigen:
False
Parametersätze
UsingSMTP
Position:
Named
Obligatorisch.:
False
Wert aus Pipeline:
False
Wert aus Pipeline nach dem Eigenschaftsnamen:
True
Wert aus verbleibenden Argumenten:
False
UsingSIP
Position:
Named
Obligatorisch.:
False
Wert aus Pipeline:
False
Wert aus Pipeline nach dem Eigenschaftsnamen:
True
Wert aus verbleibenden Argumenten:
False
-PreferredUserName
Gibt den bevorzugten Benutzernamen eines Chatkanals an.
Wenn Sie keinen Wert festlegen, ist der Standardwert der Wert des Parameters Benutzername .
Parametereigenschaften
Typ:
String
Standardwert:
None
Unterstützt Platzhalter:
False
Nicht anzeigen:
False
Parametersätze
UsingSIP
Position:
Named
Obligatorisch.:
False
Wert aus Pipeline:
False
Wert aus Pipeline nach dem Eigenschaftsnamen:
True
Wert aus verbleibenden Argumenten:
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.
Parametereigenschaften
Typ:
TimeSpan
Standardwert:
None
Unterstützt Platzhalter:
False
Nicht anzeigen:
False
Parametersätze
UsingSMTP
Position:
Named
Obligatorisch.:
False
Wert aus Pipeline:
False
Wert aus Pipeline nach dem Eigenschaftsnamen:
True
Wert aus verbleibenden Argumenten:
False
UsingSMS
Position:
Named
Obligatorisch.:
False
Wert aus Pipeline:
False
Wert aus Pipeline nach dem Eigenschaftsnamen:
True
Wert aus verbleibenden Argumenten:
False
-ReplyTo
Gibt die Kopfzeile "Antwort an" in einer Benachrichtigungs-E-Mail an.
Parametereigenschaften
Typ:
String
Standardwert:
None
Unterstützt Platzhalter:
False
Nicht anzeigen:
False
Parametersätze
UsingSMTP
Position:
Named
Obligatorisch.:
False
Wert aus Pipeline:
False
Wert aus Pipeline nach dem Eigenschaftsnamen:
True
Wert aus verbleibenden Argumenten:
False
-SCSession
Gibt ein Array von Connection-Objekten an.
Um ein Connection-Objekt abzurufen, verwenden Sie das cmdlet Get-SCManagementGroupConnection.
Geben Sie ein Verbindungsobjekt für eine Verwaltungsgruppe ein, z. B. ein Objekt, das vom Cmdlet Get-SCManagementGroupConnection zurückgegeben wird.
Parametereigenschaften
Typ:
Connection[]
Standardwert:
None
Unterstützt Platzhalter:
False
Nicht anzeigen:
False
Parametersätze
(All)
Position:
Named
Obligatorisch.:
False
Wert aus Pipeline:
False
Wert aus Pipeline nach dem Eigenschaftsnamen:
False
Wert aus verbleibenden Argumenten:
False
-Server
Gibt einen Server an, der SMTP- und Chatkanäle für Benachrichtigungen bereitstellt.
Parametereigenschaften
Typ:
String
Standardwert:
None
Unterstützt Platzhalter:
False
Nicht anzeigen:
False
Parametersätze
UsingSMTP
Position:
Named
Obligatorisch.:
True
Wert aus Pipeline:
False
Wert aus Pipeline nach dem Eigenschaftsnamen:
True
Wert aus verbleibenden Argumenten:
False
UsingSIP
Position:
Named
Obligatorisch.:
True
Wert aus Pipeline:
False
Wert aus Pipeline nach dem Eigenschaftsnamen:
True
Wert aus verbleibenden Argumenten:
False
-SipAuthentication
Gibt einen SIP-Authentifizierungsmechanismus (Session Initiation Protocol) (NTLM oder Kerberos) für Chatkanäle an.
Standardmäßig wird bei der SIP-Authentifizierung die NTLM-Authentifizierung verwendet.
Parametereigenschaften
Typ:
SipNotificationAuthenticationProtocols
Standardwert:
None
Unterstützt Platzhalter:
False
Nicht anzeigen:
False
Parametersätze
UsingSIP
Position:
Named
Obligatorisch.:
False
Wert aus Pipeline:
False
Wert aus Pipeline nach dem Eigenschaftsnamen:
True
Wert aus verbleibenden Argumenten:
False
-SipProtocol
Gibt ein SIP-Transportprotokoll (TCP oder TLS) für IM-Kanäle an.
Standardmäßig verwendet SIP TCP als Transportprotokoll.
Parametereigenschaften
Typ:
SipTransportProtocol
Standardwert:
None
Unterstützt Platzhalter:
False
Nicht anzeigen:
False
Parametersätze
UsingSIP
Position:
Named
Obligatorisch.:
False
Wert aus Pipeline:
False
Wert aus Pipeline nach dem Eigenschaftsnamen:
True
Wert aus verbleibenden Argumenten:
False
-Sms
Gibt an, dass das Cmdlet Benachrichtigungen per SMS sendet.
Parametereigenschaften
Typ:
SwitchParameter
Standardwert:
None
Unterstützt Platzhalter:
False
Nicht anzeigen:
False
Parametersätze
UsingSMS
Position:
Named
Obligatorisch.:
True
Wert aus Pipeline:
False
Wert aus Pipeline nach dem Eigenschaftsnamen:
True
Wert aus verbleibenden Argumenten:
False
-Subject
Gibt eine Betreffzeile für die Benachrichtigungs-E-Mail an.
Parametereigenschaften
Typ:
String
Standardwert:
None
Unterstützt Platzhalter:
False
Nicht anzeigen:
False
Parametersätze
UsingSMTP
Position:
Named
Obligatorisch.:
False
Wert aus Pipeline:
False
Wert aus Pipeline nach dem Eigenschaftsnamen:
True
Wert aus verbleibenden Argumenten:
False
-UserName
Gibt eine Absenderadresse für die Chatnachricht an.
Parametereigenschaften
Typ:
Uri
Standardwert:
None
Unterstützt Platzhalter:
False
Nicht anzeigen:
False
Parametersätze
UsingSIP
Position:
2
Obligatorisch.:
True
Wert aus Pipeline:
False
Wert aus Pipeline nach dem Eigenschaftsnamen:
True
Wert aus verbleibenden Argumenten:
False
-WhatIf
Zeigt, was passiert, wenn das Cmdlet ausgeführt wird.
Das Cmdlet wird nicht ausgeführt.
Parametereigenschaften
Typ:
SwitchParameter
Standardwert:
False
Unterstützt Platzhalter:
False
Nicht anzeigen:
False
Aliase:
Wi
Parametersätze
(All)
Position:
Named
Obligatorisch.:
False
Wert aus Pipeline:
False
Wert aus Pipeline nach dem Eigenschaftsnamen:
False
Wert aus verbleibenden Argumenten:
False
-WorkingDirectory
Gibt ein Arbeitsverzeichnis für einen Befehlskanal an.
Standardmäßig verwendet ein Befehlskanal den %systemdrive% als Arbeitsverzeichnis.
Parametereigenschaften
Typ:
String
Standardwert:
None
Unterstützt Platzhalter:
False
Nicht anzeigen:
False
Parametersätze
CommandAction
Position:
Named
Obligatorisch.:
False
Wert aus Pipeline:
False
Wert aus Pipeline nach dem Eigenschaftsnamen:
False
Wert aus verbleibenden Argumenten:
False
CommonParameters
Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.