Add-SCOMNotificationChannel

Module:

OperationsManager

Hiermee voegt u een meldingskanaal toe in Operations Manager.

Syntaxis

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

De cmdlet Add-SCOMNotificationChannel voegt een meldingskanaal toe in System Center - Operations Manager. Meldingskanalen informeren beheerders over een waarschuwing of voeren automatisering uit als reactie op een waarschuwing. Een meldingskanaal maakt gebruik van een leveringsmechanisme in Operations Manager, zoals e-mail, chatberichten (CHAT), Short Message Service (SMS) of opdracht voor het bezorgen van meldingen.

Voorbeelden

Voorbeeld 1: Een meldingskanaal toevoegen

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 dit voorbeeld wordt een standaard SMTP-e-mailkanaal toegevoegd.

Met de eerste opdracht wordt de onderwerpregel opgeslagen in de variabele met de naam $Subject.

Met de tweede opdracht wordt de hoofdtekst van het bericht opgeslagen in de variabele met de naam $Body.

De derde opdracht maakt gebruik van de cmdlet Add-SCOMNotificationChannel om een SMTP-e-mailkanaal toe te voegen.

Voorbeeld 2: Een meldingskanaal toevoegen voor chatberichten

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 dit voorbeeld wordt een chatkanaal met een retouradres van scomadmin toegevoegd.

Met de eerste opdracht wordt de hoofdtekst van het bericht opgeslagen in de variabele met de naam $Body.

De tweede opdracht maakt gebruik van de cmdlet Add-SCOMNotificationChannel om een chatkanaal toe te voegen.

Voorbeeld 3: Een meldingskanaal voor sms toevoegen

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 dit voorbeeld wordt een SMS-kanaal met Unicode-codering toegevoegd.

Met de eerste opdracht wordt de hoofdtekst van het bericht opgeslagen in de variabele met de naam $Body.

De tweede opdracht maakt gebruik van de cmdlet Add-SCOMNotificationChannel om een SMS-kanaal toe te voegen.

Voorbeeld 4: Een meldingskanaal voor opdrachten toevoegen

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 dit voorbeeld wordt een meldingskanaal voor opdrachten toegevoegd waarmee het OnNotify.exe-programma wordt uitgevoerd.

Met de eerste opdracht wordt het pad naar het uitvoerbare bestand opgeslagen in de variabele met de naam $Path.

Met de tweede opdracht worden de argumenten opgeslagen in de variabele met de naam $Arg.

Met de derde opdracht wordt de werkmap opgeslagen in de variabele met de naam $WorkingDir.

De vierde opdracht maakt gebruik van de cmdlet Add-SCOMNotificationChannel om een meldingskanaal voor opdrachten toe te voegen.

Parameters

-Anonymous

Geeft aan dat een anonieme SMTP-server (Simple Mail Transfer Protocol) e-mailmeldingen verzendt.

Type:	SwitchParameter
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-ApplicationPath

Hiermee geeft u het toepassingspad van een opdrachtkanaal.

Type:	String
Position:	1
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-Argument

Hiermee geeft u een lijst met argumenten aan een opdrachtkanaal.

Type:	String
Position:	2
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-BackupDevice

Hiermee geeft u een matrix van secundaire SMS-apparaten.

Type:	String[]
Position:	3
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-BackupSmtpServer

Hiermee geeft u een matrix van back-up SMTP-servers. Back-upservers gebruiken dezelfde configuratie als de primaire SMTP-server.

Type:	String[]
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-Body

Hiermee geeft u de hoofdtekst van een meldingsbericht.

Type:	String
Position:	Named
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-BodyAsHtml

Hiermee wordt aangegeven dat de hoofdtekst van het bericht wordt opgemaakt als HTML.

Type:	SwitchParameter
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-ComputerName

Hiermee geeft u een matrix van namen van computers. Met de cmdlet worden tijdelijke verbindingen met beheergroepen voor deze computers tot stand gebracht. U kunt NetBIOS-namen, IP-adressen of FQDN's (Fully Qualified Domain Names) gebruiken. Als u de lokale computer wilt opgeven, typt u de computernaam, localhost of een punt (.).

Type:	String[]
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-Confirm

U wordt gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type:	SwitchParameter
Aliassen:	cf
Position:	Named
Default value:	False
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-ContentType

Hiermee geeft u het inhoudstype van een chatbericht op. Standaard is het inhoudstype text/plain.

Type:	String
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-Credential

Hiermee geeft u een PSCredential-object voor de verbinding met de beheergroep. Als u een PSCredential--object wilt verkrijgen, gebruikt u de cmdlet Get-Credential. Typ 'Get-Help Get-Credential' voor meer informatie.

Als u een computer opgeeft in de parameter ComputerName, gebruikt u een account dat toegang heeft tot die computer. De standaardwaarde is de huidige gebruiker.

Type:	PSCredential
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-Description

Hiermee geeft u een beschrijving voor een meldingskanaal. Als u geen waarde instelt, is de standaardwaarde de waarde van de parameter DisplayName.

Type:	String
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-Device

Hiermee geeft u een primair SMS-apparaat.

Type:	String
Position:	2
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-DeviceEnumerationInterval

Hiermee geeft u een tijdsinterval tussen sms-meldingen. Standaard wacht het meldingskanaal 10 seconden.

Type:	TimeSpan
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-DisplayName

Hiermee geeft u een weergavenaam voor een meldingskanaal. Als u geen waarde instelt, is de standaardwaarde de waarde van de parameter Name.

Type:	String
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-Encoding

Hiermee geeft u de coderingsindeling voor een meldingsbericht op. Een SMTP-kanaal maakt standaard gebruik van UTF-8-codering. Een IM-kanaal maakt standaard gebruik van UTF-8-codering. Een SMS-kanaal maakt standaard gebruik van standaardcodering, maar kan ook Unicode-codering gebruiken.

Type:	String
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-ExternalEmail

Hiermee geeft u op of externe e-mail moet worden gebruikt.

Type:	SwitchParameter
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-ExternalEmailRunasProfile

Hiermee geeft u het Uitvoeren als-profiel voor externe e-mail.

Type:	String
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-From

Hiermee geeft u de Van-koptekst in een e-mailbericht voor meldingen.

Type:	String
Position:	2
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-Header

Hiermee geeft u kopteksten op, als sleutel-waardeparen, in een e-mailbericht met meldingen.

Type:	Hashtable
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-MaxPrimaryRecipientsPerMail

Hiermee geeft u het maximum aantal geadresseerden voor een e-mailbericht voor meldingen.

Type:	Int32
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-Name

Hiermee geeft u de naam van een meldingskanaal.

Type:	String
Position:	1
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-NoSubjectEncoding

Geeft aan dat de cmdlet de onderwerpregel voor e-mail niet coderen.

Type:	SwitchParameter
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-Port

Hiermee geeft u het poortnummer voor een kanaal.

Een SMTP-kanaal maakt standaard gebruik van poort 25. Een IM-kanaal dat TCP gebruikt, maakt standaard gebruik van poort 5060 en een IM-kanaal dat tls (Transport Layer Security) gebruikt, maakt standaard gebruik van poort 5061.

Type:	UInt32
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-PreferredUserName

Hiermee geeft u de voorkeursgebruikersnaam van een chatkanaal. Als u geen waarde instelt, is de standaardwaarde de waarde van de parameter Gebruikersnaam.

Type:	String
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-PrimaryRetryInterval

Hiermee geeft u een interval voor opnieuw proberen. De service probeert terug te schakelen naar de primaire SMTP-server of het SMS-apparaat. Het interval is standaard vijf minuten.

Type:	TimeSpan
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-ReplyTo

Hiermee geeft u de berichtkop Beantwoorden in een e-mailbericht met meldingen.

Type:	String
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-SCSession

Hiermee geeft u een matrix van Connection-objecten. Als u een Connection-object wilt verkrijgen, gebruikt u de cmdlet Get-SCManagementGroupConnection.

Voer een verbindingsobject in voor een beheergroep, zoals een object dat Get-SCManagementGroupConnection cmdlet retourneert.

Type:	Connection[]
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-Server

Hiermee geeft u een server die SMTP- en chatkanalen biedt voor meldingen.

Type:	String
Position:	Named
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-SipAuthentication

Hiermee geeft u een SIP-verificatiemechanisme (Session Initiation Protocol) (NTLM of Kerberos) op voor chatkanalen. SIP-verificatie maakt standaard gebruik van NTLM-verificatie.

Type:	SipNotificationAuthenticationProtocols
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-SipProtocol

Hiermee geeft u een SIP-transportprotocol (TCP of TLS) voor im-kanalen. SIP maakt standaard gebruik van TCP als transportprotocol.

Type:	SipTransportProtocol
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-Sms

Geeft aan dat de cmdlet meldingen verzendt via sms.

Type:	SwitchParameter
Position:	Named
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-Subject

Hiermee geeft u een onderwerpregel op voor het e-mailbericht met meldingen.

Type:	String
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-UserName

Hiermee geeft u een retouradres voor chatberichten.

Type:	Uri
Position:	2
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-WhatIf

Toont wat er zou gebeuren als de cmdlet wordt uitgevoerd. De cmdlet wordt niet uitgevoerd.

Type:	SwitchParameter
Aliassen:	wi
Position:	Named
Default value:	False
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-WorkingDirectory

Hiermee geeft u een werkmap voor een opdrachtkanaal. Standaard gebruikt een opdrachtkanaal de %systemdrive% als werkmap.

Type:	String
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

Verwante koppelingen

• Get-SCOMNotificationChannel
• Remove-SCOMNotificationChannel