Add-SCOMNotificationChannel
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 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 $BodyEste 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 $BodyEste 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 $WorkingDirEste 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.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ApplicationPath
Especifica o caminho do aplicativo de um canal de comando.
| 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 comando.
| 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 backup. Os servidores de backup usam 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 formata 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 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 (.).
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Confirm
Solicita 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 mensagem instantânea.
Por padrã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 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.
| 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 você não definir um valor, o padrão será 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 primário.
| Type: | String |
| Position: | 2 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-DeviceEnumerationInterval
Especifica um intervalo de tempo entre as notificações por SMS. Por padrã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 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 .
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | 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.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ExternalEmail
Especifica se o email externo deve ser usado.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ExternalEmailRunasProfile
Especifica o perfil Executar como para email externo.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-From
Especifica o cabeçalho De em uma mensagem de email 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, em uma mensagem de email 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 email 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 de assunto do email.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | 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.
| Type: | UInt32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | 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 .
| 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 alternar de volta para o servidor SMTP primário ou dispositivo SMS. Por padrã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 De resposta em uma mensagem de email 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 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.
| 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 IM 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 (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.
| 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 mensagens instantâneas. Por padrão, SIP usa 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 usando 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 email 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 mensagens instantâneas.
| Type: | Uri |
| Position: | 2 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-WhatIf
Mostra o que aconteceria se o cmdlet fosse executado. 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 comando. Por padrão, um canal de comando usa %systemdrive% como um diretório de trabalho.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |