Add-SCOMNotificationChannel

Riferimento

Modulo:: OperationsManager

Aggiunge un canale di notifica in Operations Manager.

Sintassi

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>]

Descrizione

Il cmdlet Add-SCOMNotificationChannel aggiunge un canale di notifica in System Center Operations Manager. I canali di notifica informano gli amministratori di un avviso o eseguono l'automazione in risposta a un avviso. Un canale di notifica usa un meccanismo di recapito in Operations Manager, ad esempio posta elettronica, messaggistica istantanea, Servizio messaggi brevi (SMS) o comando per recapitare le notifiche.

Esempio

Esempio 1: Aggiungere un canale di notifica

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 questo esempio viene aggiunto un canale di posta elettronica SMTP standard.

Il primo comando archivia la riga dell'oggetto nella variabile denominata $Subject.

Il secondo comando archivia il corpo del messaggio nella variabile denominata $Body.

Il terzo comando usa il cmdlet Add-SCOMNotificationChannel per aggiungere un canale di posta elettronica SMTP.

Esempio 2: Aggiungere un canale di notifica per la messaggistica istantanea

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 questo esempio viene aggiunto un canale di messaggistica istantanea con un indirizzo restituito di scomadmin.

Il primo comando archivia il corpo del messaggio nella variabile denominata $Body.

Il secondo comando usa il cmdlet Add-SCOMNotificationChannel per aggiungere un canale di messaggistica istantanea.

Esempio 3: Aggiungere un canale di notifica per 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 questo esempio viene aggiunto un canale SMS con codifica Unicode.

Il primo comando archivia il corpo del messaggio nella variabile denominata $Body.

Il secondo comando usa il cmdlet Add-SCOMNotificationChannel per aggiungere un canale SMS.

Esempio 4: Aggiungere un canale di notifica dei comandi

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 questo esempio viene aggiunto un canale di notifica del comando che esegue il programma OnNotify.exe.

Il primo comando archivia il percorso del file eseguibile nella variabile denominata $Path.

Il secondo comando archivia gli argomenti nella variabile denominata $Arg.

Il terzo comando archivia la directory di lavoro nella variabile denominata $WorkingDir.

Il quarto comando usa il cmdlet Add-SCOMNotificationChannel per aggiungere un canale di notifica dei comandi.

Parametri

-Anonymous

Indica che un server SMTP (Simple Mail Transfer Protocol) anonimo invia notifiche tramite posta elettronica.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-ApplicationPath

Specifica il percorso dell'applicazione di un canale di comando.

Type:	String
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Argument

Specifica un elenco di argomenti in un canale di comando.

Type:	String
Position:	2
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-BackupDevice

Specifica una matrice di dispositivi SMS secondari.

Type:	String[]
Position:	3
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-BackupSmtpServer

Specifica una matrice di server SMTP di backup. I server di backup usano la stessa configurazione del server SMTP primario.

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Body

Specifica il corpo di un messaggio di notifica.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-BodyAsHtml

Indica che il servizio formatta il corpo del messaggio come HTML.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-ComputerName

Specifica una matrice di nomi di computer. Il cmdlet stabilisce connessioni temporanee con i gruppi di gestione per questi computer. È possibile usare nomi NetBIOS, indirizzi IP o nomi di dominio completi (FQDN). Per specificare il computer locale, digitare il nome del computer, localhost o un punto (.).

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

Richiede la conferma dell'utente prima di eseguire il cmdlet.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ContentType

Specifica il tipo di contenuto di una messaggistica istantanea. Per impostazione predefinita, il tipo di contenuto è text/plain.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Credential

Specifica un oggetto PSCredential per la connessione al gruppo di gestione. Per ottenere un oggetto PSCredential, usare il cmdlet Get-Credential. Per altre informazioni, digitare "Get-Help Get-Credential".

Se si specifica un computer nel parametro ComputerName , utilizzare un account che abbia accesso a tale computer. Il valore predefinito è l'utente corrente.

Type:	PSCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Description

Specifica una descrizione per un canale di notifica. Se non si imposta un valore, il valore predefinito è il valore del parametro DisplayName .

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Device

Specifica un dispositivo SMS primario.

Type:	String
Position:	2
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-DeviceEnumerationInterval

Specifica un intervallo di tempo tra le notifiche SMS. Per impostazione predefinita, il canale di notifica attende 10 secondi.

Type:	TimeSpan
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-DisplayName

Specifica un nome visualizzato per un canale di notifica. Se non si imposta un valore, il valore predefinito è il valore del parametro Name .

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Encoding

Specifica il formato di codifica per un messaggio di notifica. Per impostazione predefinita, un canale SMTP usa la codifica UTF-8. Un canale di messaggistica istantanea usa anche la codifica UTF-8 per impostazione predefinita. Un canale SMS usa la codifica Predefinita per impostazione predefinita, ma può usare in alternativa la codifica Unicode.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-ExternalEmail

Specifica se utilizzare la posta elettronica esterna.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-ExternalEmailRunasProfile

Specifica il profilo Runas per la posta elettronica esterna.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-From

Specifica l'intestazione From in un messaggio di posta elettronica di notifica.

Type:	String
Position:	2
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

Specifica le intestazioni, come coppie chiave-valore, in un messaggio di posta elettronica di notifica.

Type:	Hashtable
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-MaxPrimaryRecipientsPerMail

Specifica il numero massimo di destinatari per un messaggio di posta elettronica di notifica.

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Name

Specifica il nome di un canale di notifica.

Type:	String
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-NoSubjectEncoding

Indica che il cmdlet non codifica la riga dell'oggetto del messaggio di posta elettronica.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Port

Specifica il numero di porta per un canale.

Per impostazione predefinita, un canale SMTP usa la porta 25. Un canale di messaggistica istantanea che usa TCP usa la porta 5060 per impostazione predefinita e un canale di messaggistica istantanea che usa Transport Layer Security (TLS) usa la porta 5061 per impostazione predefinita.

Type:	UInt32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-PreferredUserName

Specifica il nome utente preferito di un canale di messaggistica istantanea. Se non si imposta un valore, il valore predefinito è il valore del parametro Username .

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-PrimaryRetryInterval

Specifica un intervallo di ripetizione dei tentativi. Il servizio tenta di tornare al server SMTP primario o al dispositivo SMS. Per impostazione predefinita, l'intervallo è di cinque minuti.

Type:	TimeSpan
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-ReplyTo

Specifica l'intestazione Rispondi a in un messaggio di posta elettronica di notifica.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-SCSession

Specifica una matrice di oggetti Connection . Per ottenere un oggetto Connection , utilizzare il cmdlet Get-SCManagementGroupConnection .

Immettere un oggetto connessione per un gruppo di gestione, ad esempio quello restituito dal cmdlet Get-SCManagementGroupConnection .

Type:	Connection[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Server

Specifica un server che fornisce canali SMTP e IM per le notifiche.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-SipAuthentication

Specifica un meccanismo di autenticazione SIP (Session Initiation Protocol) (NTLM o Kerberos) per i canali di messaggistica istantanea. Per impostazione predefinita, l'autenticazione SIP usa l'autenticazione NTLM.

Type:	SipNotificationAuthenticationProtocols
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-SipProtocol

Specifica un protocollo di trasporto SIP (TCP o TLS) per i canali di messaggistica istantanea. Per impostazione predefinita, SIP usa TCP come protocollo di trasporto.

Type:	SipTransportProtocol
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Sms

Indica che il cmdlet invia notifiche tramite SMS.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Subject

Specifica una riga dell'oggetto per il messaggio di posta elettronica di notifica.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-UserName

Specifica un indirizzo restituito per la messaggistica istantanea.

Type:	Uri
Position:	2
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-WhatIf

Mostra l'esito in caso di esecuzione del cmdlet. Il cmdlet non viene eseguito.

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-WorkingDirectory

Specifica una directory di lavoro per un canale di comando. Per impostazione predefinita, un canale di comando usa %systemdrive% come directory di lavoro.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Condividi tramite