Partilhar via

Add-SCOMNotificationChannel

  • Referência
Módulo:
OperationsManager

Adiciona um canal de notificação no 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

O cmdlet Add-SCOMNotificationChannel adiciona um canal de notificação no System Center – Operations Manager. Os canais de notificação informam os administradores de um alerta ou executam a automatização em resposta a um alerta. Um canal de notificação utiliza um mecanismo de entrega no Operations Manager, como e-mail, mensagens instantâneas (MI), Serviço de Mensagens Curtas (SMS) ou comando, para entregar notificações.

Exemplos

Exemplo 1: Adicionar um canal de notificação

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

Este exemplo adiciona um canal de e-mail SMTP padrão.

O primeiro comando armazena a linha de assunto na variável denominada $Subject.

O segundo comando armazena o corpo da mensagem na variável denominada $Body.

O terceiro comando utiliza o cmdlet Add-SCOMNotificationChannel para adicionar um canal de e-mail SMTP.

Exemplo 2: Adicionar um canal de notificação para MI

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

Este exemplo adiciona um canal de MI que tem um endereço de retorno de scomadmin.

O primeiro comando armazena o corpo da mensagem na variável denominada $Body.

O segundo comando utiliza o cmdlet Add-SCOMNotificationChannel para adicionar um canal de MI.

Exemplo 3: Adicionar um canal de notificação 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"

Este exemplo adiciona um canal SMS com codificação Unicode.

O primeiro comando armazena o corpo da mensagem na variável denominada $Body.

O segundo comando utiliza o cmdlet Add-SCOMNotificationChannel para adicionar um canal SMS.

Exemplo 4: Adicionar um canal de notificação 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

Este exemplo adiciona um canal de notificação de comandos que executa o programa OnNotify.exe.

O primeiro comando armazena o caminho para o ficheiro executável na variável denominada $Path.

O segundo comando armazena os argumentos na variável denominada $Arg.

O terceiro comando armazena o diretório de trabalho na variável denominada $WorkingDir.

O quarto comando utiliza o cmdlet Add-SCOMNotificationChannel para adicionar um canal de notificação de comandos.

Parâmetros

-Anonymous

Indica que um servidor SMTP (Simple Mail Transfer Protocol) anónimo envia notificações por e-mail.

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

-ApplicationPath

Especifica o caminho da aplicação de um canal de comandos.

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

-Argument

Especifica uma lista de argumentos para um canal de comandos.

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

-BackupDevice

Especifica uma matriz de dispositivos SMS secundários.

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

-BackupSmtpServer

Especifica uma matriz de servidores SMTP de cópia de segurança. Os servidores de cópia de segurança utilizam a mesma configuração que o servidor SMTP primário.

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

-Body

Especifica o corpo de uma mensagem de notificação.

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

-BodyAsHtml

Indica que o serviço formatará o corpo da mensagem como HTML.

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

-ComputerName

Especifica uma matriz de nomes de computadores. O cmdlet estabelece ligações temporárias com grupos de gestão para estes computadores. Pode utilizar nomes NetBIOS, endereços IP ou nomes de domínio completamente qualificados (FQDNs). Para especificar o computador local, escreva o nome do computador, localhost ou um ponto (.).

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

-Confirm

Solicita a sua confirmação antes de executar o cmdlet.

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

-ContentType

Especifica o tipo de conteúdo de uma MI. Por predefinição, o tipo de conteúdo é text/plain.

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

-Credential

Especifica um objeto PSCredential para a ligação do grupo de gestão. Para obter um objeto PSCredential , utilize o cmdlet Get-Credential . Para obter mais informações, escreva "Get-Help Get-Credential".

Se especificar um computador no parâmetro ComputerName , utilize uma conta que tenha acesso a esse computador. A predefinição é o utilizador atual.

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

-Description

Especifica uma descrição para um canal de notificação. Se não definir um valor, a predefinição é o valor do parâmetro DisplayName .

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

-Device

Especifica um dispositivo SMS principal.

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

-DeviceEnumerationInterval

Especifica um intervalo de tempo entre notificações POR SMS. Por predefinição, o canal de notificação aguarda 10 segundos.

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

-DisplayName

Especifica um nome a apresentar para um canal de notificação. Se não definir um valor, a predefinição é o valor do parâmetro Nome .

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

-Encoding

Especifica o formato de codificação de uma mensagem de notificação. Por predefinição, um canal SMTP utiliza a codificação UTF-8. Um canal de MI também utiliza a codificação UTF-8 por predefinição. Por predefinição, um canal SMS utiliza a codificação predefinida, mas pode utilizar a codificação Unicode em alternativa.

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

-ExternalEmail

Especifica se deve utilizar e-mails externos.

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

-ExternalEmailRunasProfile

Especifica o perfil Executar como para e-mail externo.

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

-From

Especifica o cabeçalho De numa mensagem de e-mail de notificação.

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

-Header

Especifica cabeçalhos, como pares chave-valor, numa mensagem de e-mail de notificação.

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

-MaxPrimaryRecipientsPerMail

Especifica o número máximo de destinatários para uma mensagem de e-mail de notificação.

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

-Name

Especifica o nome de um canal de notificação.

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

-NoSubjectEncoding

Indica que o cmdlet não codifica a linha do assunto do e-mail.

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

-Port

Especifica o número de porta de um canal.

Por predefinição, um canal SMTP utiliza a porta 25. Um canal de MI que utiliza TCP utiliza a porta 5060 por predefinição e um canal de MI que utiliza o Transport Layer Security (TLS) utiliza a porta 5061 por predefinição.

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

-PreferredUserName

Especifica o nome de utilizador preferencial de um canal de MI. Se não definir um valor, a predefinição é o valor do parâmetro Nome de utilizador .

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

-PrimaryRetryInterval

Especifica um intervalo de repetição. O serviço tenta mudar novamente para o servidor SMTP principal ou dispositivo SMS. Por predefinição, o intervalo é de cinco minutos.

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

-ReplyTo

Especifica o cabeçalho Responder a numa mensagem de e-mail de notificação.

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

-SCSession

Especifica uma matriz de objetos de Ligação . Para obter um objeto Ligação , utilize o cmdlet Get-SCManagementGroupConnection .

Introduza um objeto de ligação para um grupo de gestão, como um que o cmdlet Get-SCManagementGroupConnection devolve.

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

-Server

Especifica um servidor que fornece canais SMTP e MI para notificações.

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

-SipAuthentication

Especifica um mecanismo de autenticação SIP (Session Initiation Protocol) (NTLM ou Kerberos) para canais de MI. Por predefinição, a autenticação SIP utiliza a autenticação NTLM.

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

-SipProtocol

Especifica um protocolo de transporte SIP (TCP ou TLS) para canais de MI. Por predefinição, o SIP utiliza o TCP como um protocolo de transporte.

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

-Sms

Indica que o cmdlet envia notificações através de SMS.

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

-Subject

Especifica uma linha de assunto para a mensagem de e-mail de notificação.

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

-UserName

Especifica um endereço de retorno para MI.

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

-WhatIf

Apresenta o que aconteceria mediante a execução do cmdlet. O cmdlet não é executado.

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

-WorkingDirectory

Especifica um diretório de trabalho para um canal de comandos. Por predefinição, um canal de comandos utiliza o %systemdrive% como um diretório de trabalho.

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