Compartir a través de

Add-SCOMNotificationChannel

Módulo:
OperationsManager Module

Agrega un canal de notificación en Operations Manager.

Sintaxis

UsingSMTP (Es el valor predeterminado). 

Add-SCOMNotificationChannel
    [-Name] <String>
    [-From] <String>
    -Server <String>
    -Body <String>
    [-Port <UInt32>]
    [-DisplayName <String>]
    [-Description <String>]
    [-ReplyTo <String>]
    [-Header <Hashtable>]
    [-Anonymous]
    [-ExternalEmail]
    [-ExternalEmailRunasProfile <String>]
    [-BackupSmtpServer <String[]>]
    [-MaxPrimaryRecipientsPerMail <Int32>]
    [-PrimaryRetryInterval <TimeSpan>]
    [-Subject <String>]
    [-BodyAsHtml]
    [-Encoding <String>]
    [-NoSubjectEncoding]
    [-SCSession <Connection[]>]
    [-ComputerName <String[]>]
    [-Credential <PSCredential>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

UsingSIP 

Add-SCOMNotificationChannel
    [-Name] <String>
    [-UserName] <Uri>
    -Server <String>
    -Body <String>
    [-Port <UInt32>]
    [-DisplayName <String>]
    [-Description <String>]
    [-ContentType <String>]
    [-SipProtocol <SipTransportProtocol>]
    [-SipAuthentication <SipNotificationAuthenticationProtocols>]
    [-PreferredUserName <String>]
    [-Encoding <String>]
    [-SCSession <Connection[]>]
    [-ComputerName <String[]>]
    [-Credential <PSCredential>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

CommandAction 

Add-SCOMNotificationChannel
    [-Name] <String>
    [-ApplicationPath] <String>
    [[-Argument] <String>]
    [-DisplayName <String>]
    [-Description <String>]
    [-WorkingDirectory <String>]
    [-SCSession <Connection[]>]
    [-ComputerName <String[]>]
    [-Credential <PSCredential>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

UsingSMS 

Add-SCOMNotificationChannel
    [-Name] <String>
    [[-Device] <String>]
    [[-BackupDevice] <String[]>]
    -Body <String>
    [-DisplayName <String>]
    [-Description <String>]
    [-PrimaryRetryInterval <TimeSpan>]
    [-DeviceEnumerationInterval <TimeSpan>]
    [-Sms]
    [-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: Agregar 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 mensajería instantánea 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 mensajería instantánea.

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.

Propiedades del parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

UsingSMTP
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-ApplicationPath

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

Propiedades del parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

CommandAction
Posición:1
Mandatory:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Argument

Especifica una lista de argumentos en un canal de comandos.

Propiedades del parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

CommandAction
Posición:2
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-BackupDevice

Especifica una matriz de dispositivos SMS secundarios.

Propiedades del parámetro

Tipo:

String[]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

UsingSMS
Posición:3
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes: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.

Propiedades del parámetro

Tipo:

String[]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

UsingSMTP
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-Body

Especifica el cuerpo de un mensaje de notificación.

Propiedades del parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

UsingSMTP
Posición:Named
Mandatory:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False
UsingSIP
Posición:Named
Mandatory:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False
UsingSMS
Posición:Named
Mandatory:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-BodyAsHtml

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

Propiedades del parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

UsingSMTP
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes: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 (.).

Propiedades del parámetro

Tipo:

String[]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Confirm

Le pide confirmación antes de ejecutar el cmdlet.

Propiedades del parámetro

Tipo:SwitchParameter
Valor predeterminado:False
Admite caracteres comodín:False
DontShow:False
Alias:cf

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-ContentType

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

Propiedades del parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

UsingSIP
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-Credential

Especifica un objeto de PSCredential para la conexión del grupo de administración. Para obtener un objeto de de PSCredential, use el cmdlet get-credential de . 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.

Propiedades del parámetro

Tipo:PSCredential
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes: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.

Propiedades del parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-Device

Especifica un dispositivo SMS principal.

Propiedades del parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

UsingSMS
Posición:2
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-DeviceEnumerationInterval

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

Propiedades del parámetro

Tipo:TimeSpan
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

UsingSMS
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes: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.

Propiedades del parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes: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.

Propiedades del parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

UsingSMTP
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False
UsingSIP
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False
UsingSMS
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-ExternalEmail

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

Propiedades del parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

UsingSMTP
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-ExternalEmailRunasProfile

Especifica el perfil de ejecución para el correo electrónico externo.

Propiedades del parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

UsingSMTP
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-From

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

Propiedades del parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

UsingSMTP
Posición:2
Mandatory:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-Header

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

Propiedades del parámetro

Tipo:Hashtable
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

UsingSMTP
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-MaxPrimaryRecipientsPerMail

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

Propiedades del parámetro

Tipo:Int32
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

UsingSMTP
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-Name

Especifica el nombre de un canal de notificación.

Propiedades del parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:1
Mandatory:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-NoSubjectEncoding

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

Propiedades del parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

UsingSMTP
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-Port

Especifica el número de puerto de un canal.

Un canal SMTP usa el puerto 25 de forma predeterminada. Un canal de mensajería instantánea 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.

Propiedades del parámetro

Tipo:UInt32
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

UsingSMTP
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False
UsingSIP
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-PreferredUserName

Especifica el nombre de usuario preferido de un canal de mensajería instantánea. Si no establece un valor, el valor predeterminado es el valor del parámetro Username.

Propiedades del parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

UsingSIP
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes: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.

Propiedades del parámetro

Tipo:TimeSpan
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

UsingSMTP
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False
UsingSMS
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-ReplyTo

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

Propiedades del parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

UsingSMTP
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-SCSession

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

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

Propiedades del parámetro

Tipo:

Connection[]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Server

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

Propiedades del parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

UsingSMTP
Posición:Named
Mandatory:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False
UsingSIP
Posición:Named
Mandatory:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes: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.

Propiedades del parámetro

Tipo:SipNotificationAuthenticationProtocols
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

UsingSIP
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes: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.

Propiedades del parámetro

Tipo:SipTransportProtocol
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

UsingSIP
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-Sms

Indica que el cmdlet envía notificaciones mediante SMS.

Propiedades del parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

UsingSMS
Posición:Named
Mandatory:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-Subject

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

Propiedades del parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

UsingSMTP
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-UserName

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

Propiedades del parámetro

Tipo:Uri
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

UsingSIP
Posición:2
Mandatory:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-WhatIf

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

Propiedades del parámetro

Tipo:SwitchParameter
Valor predeterminado:False
Admite caracteres comodín:False
DontShow:False
Alias:Wi

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-WorkingDirectory

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

Propiedades del parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

CommandAction
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

CommonParameters

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.