Add-SCOMNotificationChannel

Referencia

Módulo:: OperationsManager

Agrega un canal de notificación en Operations Manager.

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

Description

El cmdlet Add-SCOMNotificationChannel agrega un canal de notificación en System Center Operations Manager. Los canales de notificación informan a los administradores de una alerta o ejecutan la automatización en respuesta a una alerta. Un canal de notificación usa un mecanismo de entrega en Operations Manager, como correo electrónico, mensajería instantánea (MI), Servicio de mensajes cortos (SMS) o comando para entregar notificaciones.

Ejemplos

Ejemplo 1: Agregar un canal de notificación

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

En este ejemplo se agrega un canal de correo electrónico SMTP estándar.

El primer comando almacena la línea de asunto en la variable denominada $Subject.

El segundo comando almacena el cuerpo del mensaje en la variable denominada $Body.

El tercer comando usa el cmdlet Add-SCOMNotificationChannel para agregar un canal de correo electrónico SMTP.

Ejemplo 2: Adición de un canal de notificación para mensajería instantánea

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

En este ejemplo se agrega un canal de MI que tiene una dirección de retorno de scomadmin.

El primer comando almacena el cuerpo del mensaje en la variable denominada $Body.

El segundo comando usa el cmdlet Add-SCOMNotificationChannel para agregar un canal de MI.

Ejemplo 3: Agregar un canal de notificación para 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"

En este ejemplo se agrega un canal SMS que tiene codificación Unicode.

El primer comando almacena el cuerpo del mensaje en la variable denominada $Body.

El segundo comando usa el cmdlet Add-SCOMNotificationChannel para agregar un canal SMS.

Ejemplo 4: Agregar un canal de notificación de comandos

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

En este ejemplo se agrega un canal de notificación de comandos que ejecuta el programa OnNotify.exe.

El primer comando almacena la ruta de acceso al archivo ejecutable en la variable denominada $Path.

El segundo comando almacena los argumentos en la variable denominada $Arg.

El tercer comando almacena el directorio de trabajo en la variable denominada $WorkingDir.

El cuarto comando usa el cmdlet Add-SCOMNotificationChannel para agregar un canal de notificación de comandos.

Parámetros

-Anonymous

Indica que un servidor de Protocolo simple de transferencia de correo (SMTP) anónimo envía notificaciones por correo electrónico.

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

-ApplicationPath

Especifica la ruta de acceso de la aplicación de un canal de comandos.

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

-Argument

Especifica una lista de argumentos para un canal de comandos.

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

-BackupDevice

Especifica una matriz de dispositivos SMS secundarios.

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

-BackupSmtpServer

Especifica una matriz de servidores SMTP de copia de seguridad. Los servidores de copia de seguridad usan la misma configuración que el servidor SMTP principal.

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

-Body

Especifica el cuerpo de un mensaje de notificación.

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

-BodyAsHtml

Indica que el servicio da formato al cuerpo del mensaje como HTML.

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

-ComputerName

Especifica una matriz de nombres de equipos. El cmdlet establece conexiones temporales con grupos de administración para estos equipos. Puede usar nombres NetBIOS, direcciones IP o nombres de dominio completos (FQDN). Para especificar el equipo local, escriba el nombre del equipo, localhost o un punto (.).

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

-Confirm

Le solicita su confirmación antes de ejecutar el cmdlet.

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

-ContentType

Especifica el tipo de contenido de una mensajería instantánea. De forma predeterminada, el tipo de contenido es text/plain.

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

-Credential

Especifica un objeto PSCredential para la conexión del grupo de administración. Para obtener un objeto PSCredential, use el cmdlet Get-Credential. Para obtener más información, escriba "Get-Help Get-Credential".

Si especifica un equipo en el parámetro ComputerName , use una cuenta que tenga acceso a ese equipo. El valor predeterminado es el usuario actual.

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

-Description

Especifica una descripción para un canal de notificación. Si no establece un valor, el valor predeterminado es el valor del parámetro DisplayName .

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

-Device

Especifica un dispositivo SMS principal.

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

-DeviceEnumerationInterval

Especifica un intervalo de tiempo entre las notificaciones SMS. De forma predeterminada, el canal de notificación espera 10 segundos.

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

-DisplayName

Especifica un nombre para mostrar para un canal de notificación. Si no establece un valor, el valor predeterminado es el valor del parámetro Name .

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

-Encoding

Especifica el formato de codificación de un mensaje de notificación. Un canal SMTP usa la codificación UTF-8 de forma predeterminada. Un canal de mensajería instantánea también usa la codificación UTF-8 de forma predeterminada. Un canal SMS usa la codificación predeterminada de forma predeterminada, pero también puede usar la codificación Unicode.

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

-ExternalEmail

Especifica si se va a usar el correo electrónico externo.

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

-ExternalEmailRunasProfile

Especifica el perfil ejecutar como para el correo electrónico externo.

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

-From

Especifica el encabezado From en un mensaje de correo electrónico de notificación.

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

Especifica encabezados, como pares clave-valor, en un mensaje de correo electrónico de notificación.

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

-MaxPrimaryRecipientsPerMail

Especifica el número máximo de destinatarios para un mensaje de correo electrónico de notificación.

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

-Name

Especifica el nombre de un canal de notificación.

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

-NoSubjectEncoding

Indica que el cmdlet no codifica la línea de asunto del correo electrónico.

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

-Port

Especifica el número de puerto de un canal.

Un canal SMTP usa el puerto 25 de forma predeterminada. Un canal de MI que usa TCP usa el puerto 5060 de forma predeterminada y un canal de mensajería instantánea que usa seguridad de la capa de transporte (TLS) usa el puerto 5061 de forma predeterminada.

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

-PreferredUserName

Especifica el nombre de usuario preferido de un canal de mi. Si no establece un valor, el valor predeterminado es el valor del parámetro Username .

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

-PrimaryRetryInterval

Especifica un intervalo de reintento. El servicio intenta volver al servidor SMTP principal o al dispositivo SMS. De forma predeterminada, el intervalo es de cinco minutos.

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

-ReplyTo

Especifica el encabezado Responder a en un mensaje de correo electrónico de notificación.

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

-SCSession

Especifica una matriz de objetos Connection . Para obtener un objeto Connection , use el cmdlet Get-SCManagementGroupConnection .

Escriba un objeto de conexión para un grupo de administración, como el que devuelve el cmdlet Get-SCManagementGroupConnection .

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

-Server

Especifica un servidor que proporciona canales SMTP y MI para las notificaciones.

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

-SipAuthentication

Especifica un mecanismo de autenticación del Protocolo de inicio de sesión (SIP) (NTLM o Kerberos) para los canales de mensajería instantánea. De forma predeterminada, la autenticación SIP usa la autenticación NTLM.

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

-SipProtocol

Especifica un protocolo de transporte SIP (TCP o TLS) para los canales de mensajería instantánea. De forma predeterminada, SIP usa TCP como protocolo de transporte.

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

-Sms

Indica que el cmdlet envía notificaciones mediante SMS.

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

-Subject

Especifica una línea de asunto para el mensaje de correo electrónico de notificación.

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

-UserName

Especifica una dirección de devolución para MI.

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

-WhatIf

Muestra lo que sucedería si se ejecutara el cmdlet. El cmdlet no se ejecuta.

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

-WorkingDirectory

Especifica un directorio de trabajo para un canal de comandos. De forma predeterminada, un canal de comandos usa %systemdrive% como directorio de trabajo.

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