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 dei comandi 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.

Tipo:	SwitchParameter
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	True
Accettare caratteri jolly:	False

-ApplicationPath

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

Tipo:	String
Posizione:	1
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-Argument

Specifica un elenco di argomenti per un canale di comando.

Tipo:	String
Posizione:	2
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-BackupDevice

Specifica una matrice di dispositivi SMS secondari.

Tipo:	String[]
Posizione:	3
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	True
Accettare caratteri jolly:	False

-BackupSmtpServer

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

Tipo:	String[]
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	True
Accettare caratteri jolly:	False

-Body

Specifica il corpo di un messaggio di notifica.

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	True
Accettare caratteri jolly:	False

-BodyAsHtml

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

Tipo:	SwitchParameter
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	True
Accettare caratteri jolly:	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 (.).

Tipo:	String[]
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-Confirm

Richiede conferma prima di eseguire il cmdlet.

Tipo:	SwitchParameter
Alias:	cf
Posizione:	Named
Valore predefinito:	False
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-ContentType

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

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	True
Accettare caratteri jolly:	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.

Tipo:	PSCredential
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-Description

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

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	True
Accettare caratteri jolly:	False

-Device

Specifica un dispositivo SMS primario.

Tipo:	String
Posizione:	2
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	True
Accettare caratteri jolly:	False

-DeviceEnumerationInterval

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

Tipo:	TimeSpan
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	True
Accettare caratteri jolly:	False

-DisplayName

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

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	True
Accettare caratteri jolly:	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. Per impostazione predefinita, un canale SMS usa la codifica predefinita, ma può usare in alternativa la codifica Unicode.

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	True
Accettare caratteri jolly:	False

-ExternalEmail

Specifica se utilizzare la posta elettronica esterna.

Tipo:	SwitchParameter
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	True
Accettare caratteri jolly:	False

-ExternalEmailRunasProfile

Specifica il profilo Runas per la posta elettronica esterna.

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	True
Accettare caratteri jolly:	False

-From

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

Tipo:	String
Posizione:	2
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	True
Accettare caratteri jolly:	False

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

Tipo:	Hashtable
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	True
Accettare caratteri jolly:	False

-MaxPrimaryRecipientsPerMail

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

Tipo:	Int32
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	True
Accettare caratteri jolly:	False

-Name

Specifica il nome di un canale di notifica.

Tipo:	String
Posizione:	1
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	True
Accettare caratteri jolly:	False

-NoSubjectEncoding

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

Tipo:	SwitchParameter
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	True
Accettare caratteri jolly:	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.

Tipo:	UInt32
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	True
Accettare caratteri jolly:	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 nome utente .

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	True
Accettare caratteri jolly:	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.

Tipo:	TimeSpan
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	True
Accettare caratteri jolly:	False

-ReplyTo

Specifica l'intestazione Reply-to in un messaggio di posta elettronica di notifica.

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	True
Accettare caratteri jolly:	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.

Tipo:	Connection[]
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-Server

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

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	True
Accettare caratteri jolly:	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.

Tipo:	SipNotificationAuthenticationProtocols
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	True
Accettare caratteri jolly:	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.

Tipo:	SipTransportProtocol
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	True
Accettare caratteri jolly:	False

-Sms

Indica che il cmdlet invia notifiche tramite SMS.

Tipo:	SwitchParameter
Posizione:	Named
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	True
Accettare caratteri jolly:	False

-Subject

Specifica un oggetto per il messaggio di posta elettronica di notifica.

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	True
Accettare caratteri jolly:	False

-UserName

Specifica un indirizzo restituito per la messaggistica istantanea.

Tipo:	Uri
Posizione:	2
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	True
Accettare caratteri jolly:	False

-WhatIf

Mostra cosa accadrebbe se il cmdlet viene eseguito. Il cmdlet non viene eseguito.

Tipo:	SwitchParameter
Alias:	wi
Posizione:	Named
Valore predefinito:	False
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-WorkingDirectory

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

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

Condividi tramite