Compartilhar via

Add-SCOMNotificationChannel

Módulo:
OperationsManager Module

Adiciona um canal de notificação no Operations Manager.

Sintaxe

UsingSMTP (Padrão) 

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

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 automação em resposta a um alerta. Um canal de notificação usa um mecanismo de entrega no Operations Manager, como email, mensagens instantâneas (IM), SMS (Serviço de Mensagem Curta) 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 email SMTP padrão.

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

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

O terceiro comando usa o cmdlet Add-SCOMNotificationChannel para adicionar um canal de email SMTP.

Exemplo 2: Adicionar um canal de notificação para mensagens instantâneas

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 mensagens instantâneas que tem um endereço de retorno de scomadmin.

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

O segundo comando usa o cmdlet Add-SCOMNotificationChannel para adicionar um canal de mensagens instantâneas.

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 que tem codificação Unicode.

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

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

Exemplo 4: Adicionar um canal de notificação de comando

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 comando que executa o programa OnNotify.exe.

O primeiro comando armazena o caminho para o arquivo executável na variável chamada $Path.

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

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

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

Parâmetros

-Anonymous

Indica que um servidor SMTP (Simple Mail Transfer Protocol) anônimo envia notificações por email.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

UsingSMTP
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-ApplicationPath

Especifica o caminho do aplicativo de um canal de comando.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

CommandAction
Cargo:1
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Argument

Especifica uma lista de argumentos para um canal de comando.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

CommandAction
Cargo:2
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-BackupDevice

Especifica uma matriz de dispositivos SMS secundários.

Propriedades do parâmetro

Tipo:

String[]

Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

UsingSMS
Cargo:3
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-BackupSmtpServer

Especifica uma matriz de servidores SMTP de backup. Os servidores de backup usam a mesma configuração que o servidor SMTP primário.

Propriedades do parâmetro

Tipo:

String[]

Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

UsingSMTP
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-Body

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

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

UsingSMTP
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False
UsingSIP
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False
UsingSMS
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-BodyAsHtml

Indica que o serviço formata o corpo da mensagem como HTML.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

UsingSMTP
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-ComputerName

Especifica uma matriz de nomes de computadores. O cmdlet estabelece conexões temporárias com grupos de gerenciamento para esses computadores. Você pode usar nomes NetBIOS, endereços IP ou FQDNs (nomes de domínio totalmente qualificados). Para especificar o computador local, digite o nome do computador, localhost ou um ponto (.).

Propriedades do parâmetro

Tipo:

String[]

Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Confirm

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

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:False
Dá suporte a curingas:False
DontShow:False
Aliases:cf

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-ContentType

Especifica o tipo de conteúdo de uma mensagem instantânea. Por padrão, o tipo de conteúdo é text/plain.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

UsingSIP
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-Credential

Especifica um objeto PSCredential para a conexão do grupo de gerenciamento. Para obter um objeto PSCredential, use o cmdlet Get-Credential. Para obter mais informações, digite "Get-Help Get-Credential".

Se você especificar um computador no parâmetro ComputerName, use uma conta que tenha acesso a esse computador. O padrão é o usuário atual.

Propriedades do parâmetro

Tipo:PSCredential
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Description

Especifica uma descrição para um canal de notificação. Se você não definir um valor, o padrão será o valor do parâmetro DisplayName.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-Device

Especifica um dispositivo SMS primário.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

UsingSMS
Cargo:2
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-DeviceEnumerationInterval

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

Propriedades do parâmetro

Tipo:TimeSpan
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

UsingSMS
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-DisplayName

Especifica um nome de exibição para um canal de notificação. Se você não definir um valor, o padrão será o valor do parâmetro Name.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-Encoding

Especifica o formato de codificação para uma mensagem de notificação. Um canal SMTP usa a codificação UTF-8 por padrão. Um canal de mensagens instantâneas também usa a codificação UTF-8 por padrão. Um canal SMS usa a codificação padrão por padrão, mas pode usar a codificação Unicode como alternativa.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

UsingSMTP
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False
UsingSIP
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False
UsingSMS
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-ExternalEmail

Especifica se o email externo deve ser usado.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

UsingSMTP
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-ExternalEmailRunasProfile

Especifica o perfil Executar como para email externo.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

UsingSMTP
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-From

Especifica o cabeçalho De em uma mensagem de email de notificação.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

UsingSMTP
Cargo:2
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-Header

Especifica cabeçalhos, como pares chave-valor, em uma mensagem de email de notificação.

Propriedades do parâmetro

Tipo:Hashtable
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

UsingSMTP
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-MaxPrimaryRecipientsPerMail

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

Propriedades do parâmetro

Tipo:Int32
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

UsingSMTP
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-Name

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

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:1
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-NoSubjectEncoding

Indica que o cmdlet não codifica a linha de assunto de email.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

UsingSMTP
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-Port

Especifica o número da porta de um canal.

Um canal SMTP usa a porta 25 por padrão. Um canal de mensagens instantâneas que usa TCP usa a porta 5060 por padrão e um canal de mensagens instantâneas que usa a TLS (Transport Layer Security) usa a porta 5061 por padrão.

Propriedades do parâmetro

Tipo:UInt32
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

UsingSMTP
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False
UsingSIP
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-PreferredUserName

Especifica o nome de usuário preferencial de um canal de mensagens instantâneas. Se você não definir um valor, o padrão será o valor do parâmetro Username.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

UsingSIP
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-PrimaryRetryInterval

Especifica um intervalo de repetição. O serviço tenta alternar de volta para o servidor SMTP primário ou o dispositivo SMS. Por padrão, o intervalo é de cinco minutos.

Propriedades do parâmetro

Tipo:TimeSpan
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

UsingSMTP
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False
UsingSMS
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-ReplyTo

Especifica o cabeçalho de resposta em uma mensagem de email de notificação.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

UsingSMTP
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-SCSession

Especifica uma matriz de objetos Connection. Para obter um objeto Connection, use o cmdlet Get-SCManagementGroupConnection .

Insira um objeto de conexão para um grupo de gerenciamento, como um que o cmdlet Get-SCManagementGroupConnection retorna.

Propriedades do parâmetro

Tipo:

Connection[]

Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Server

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

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

UsingSMTP
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False
UsingSIP
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-SipAuthentication

Especifica um mecanismo de autenticação SIP (Protocolo de Iniciação de Sessão) (NTLM ou Kerberos) para canais de mensagens instantâneas. Por padrão, a autenticação SIP usa a autenticação NTLM.

Propriedades do parâmetro

Tipo:SipNotificationAuthenticationProtocols
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

UsingSIP
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-SipProtocol

Especifica um protocolo de transporte SIP (TCP ou TLS) para canais de mensagens instantâneas. Por padrão, o SIP usa TCP como um protocolo de transporte.

Propriedades do parâmetro

Tipo:SipTransportProtocol
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

UsingSIP
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-Sms

Indica que o cmdlet envia notificações usando SMS.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

UsingSMS
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-Subject

Especifica uma linha de assunto para a mensagem de email de notificação.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

UsingSMTP
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-UserName

Especifica um endereço de retorno para mensagens instantâneas.

Propriedades do parâmetro

Tipo:Uri
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

UsingSIP
Cargo:2
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:False
Dá suporte a curingas:False
DontShow:False
Aliases:wi

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-WorkingDirectory

Especifica um diretório de trabalho para um canal de comando. Por padrão, um canal de comando usa o %systemdrive% como um diretório de trabalho.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

CommandAction
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.