Add-SCOMNotificationChannel

Referenz

Modul:: OperationsManager

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

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

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

In 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

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

Share via