Add-SCOMNotificationChannel

모듈:

OperationsManager

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

Add-SCOMNotificationChannel cmdlet은 System Center - Operations Manager에 알림 채널을 추가합니다. 알림 채널은 관리자에게 경고를 알리거나 경고에 대한 응답으로 자동화를 실행합니다. 알림 채널은 메일, 메신저 대화(메신저), SMS(Short Message Service) 또는 명령과 같은 Operations Manager의 배달 메커니즘을 사용하여 알림을 배달합니다.

예제

예제 1: 알림 채널 추가

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

이 예제에서는 표준 SMTP 전자 메일 채널을 추가합니다.

첫 번째 명령은 제목 줄을 $Subject 변수에 저장합니다.

두 번째 명령은 메시지 본문을 $Body 변수에 저장합니다.

세 번째 명령은 Add-SCOMNotificationChannel cmdlet을 사용하여 SMTP 이메일 채널을 추가합니다.

예제 2: 메신저 대화에 대한 알림 채널 추가

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

이 예제에서는 scomadmin의 반환 주소가 있는 IM 채널을 추가합니다.

첫 번째 명령은 메시지 본문을 $Body 변수에 저장합니다.

두 번째 명령은 Add-SCOMNotificationChannel cmdlet을 사용하여 IM 채널을 추가합니다.

예제 3: 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"

다음은 유니코드 인코딩이 있는 SMS 채널을 추가하는 예제입니다.

첫 번째 명령은 메시지 본문을 $Body 변수에 저장합니다.

두 번째 명령은 Add-SCOMNotificationChannel cmdlet을 사용하여 SMS 채널을 추가합니다.

예제 4: 명령 알림 채널 추가

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

다음은 OnNotify.exe 프로그램을 실행하는 명령 알림 채널을 추가하는 예제입니다.

첫 번째 명령은 실행 파일의 경로를 $Path 변수에 저장합니다.

두 번째 명령은 인수를 $Arg 변수에 저장합니다.

세 번째 명령은 작업 디렉터리를 $WorkingDir 변수에 저장합니다.

네 번째 명령은 Add-SCOMNotificationChannel cmdlet을 사용하여 명령 알림 채널을 추가합니다.

매개 변수

-Anonymous

익명 SMTP(Simple Mail Transfer Protocol) 서버가 메일 알림 보냅니다.

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

-ApplicationPath

명령 채널의 애플리케이션 경로를 지정합니다.

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

-Argument

명령 채널에 대한 인수 목록을 지정합니다.

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

-BackupDevice

보조 SMS 디바이스의 배열을 지정합니다.

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

-BackupSmtpServer

백업 SMTP 서버의 배열을 지정합니다. 백업 서버는 기본 SMTP 서버와 동일한 구성을 사용합니다.

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

-Body

알림 메시지의 본문을 지정합니다.

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

-BodyAsHtml

서비스가 메시지 본문의 서식을 HTML로 지정했음을 나타냅니다.

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

-ComputerName

컴퓨터 이름 배열을 지정합니다. cmdlet은 이러한 컴퓨터에 대한 관리 그룹과 임시 연결을 설정합니다. NetBIOS 이름, IP 주소 또는 FQDN(정규화된 도메인 이름)을 사용할 수 있습니다. 로컬 컴퓨터를 지정하려면 컴퓨터 이름, localhost 또는 점(.)을 입력합니다.

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

-Confirm

cmdlet을 실행하기 전에 확인을 요청합니다.

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

-ContentType

메신저 대화의 콘텐츠 형식을 지정합니다. 기본적으로 콘텐츠 형식은 입니다 text/plain.

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

-Credential

관리 그룹 연결에 대한 PSCredential 개체를 지정합니다. PSCredential 개체를 가져오려면 Get-Credential cmdlet을 사용합니다. 자세한 내용은 "Get-Help Get-Credential"를 입력합니다.

ComputerName 매개 변수에서 컴퓨터를 지정하는 경우 해당 컴퓨터에 액세스할 수 있는 계정을 사용합니다. 기본값은 현재 사용자입니다.

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

-Description

알림 채널에 대한 설명을 지정합니다. 값을 설정하지 않으면 기본값은 DisplayName 매개 변수의 값입니다.

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

-Device

기본 SMS 디바이스를 지정합니다.

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

-DeviceEnumerationInterval

SMS 알림 사이의 시간 간격을 지정합니다. 기본적으로 알림 채널은 10초 동안 대기합니다.

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

-DisplayName

알림 채널의 표시 이름을 지정합니다. 값을 설정하지 않으면 기본값은 Name 매개 변수의 값입니다.

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

-Encoding

알림 메시지의 인코딩 형식을 지정합니다. SMTP 채널은 기본적으로 UTF-8 인코딩을 사용합니다. 메신저 채널은 기본적으로 UTF-8 인코딩도 사용합니다. SMS 채널은 기본적으로 기본 인코딩을 사용하지만 유니코드 인코딩을 사용할 수도 있습니다.

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

-ExternalEmail

외부 전자 메일을 사용할지 여부를 지정합니다.

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

-ExternalEmailRunasProfile

외부 전자 메일의 실행 프로필을 지정합니다.

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

-From

알림 전자 메일 메시지에서 보낸 편지 헤더를 지정합니다.

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

-Header

알림 전자 메일 메시지에서 헤더를 키-값 쌍으로 지정합니다.

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

-MaxPrimaryRecipientsPerMail

알림 전자 메일 메시지의 최대 받는 사람 수를 지정합니다.

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

-Name

알림 채널의 이름을 지정합니다.

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

-NoSubjectEncoding

cmdlet이 이메일 제목 줄을 인코딩하지 않음을 나타냅니다.

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

-Port

채널의 포트 번호를 지정합니다.

SMTP 채널은 기본적으로 포트 25를 사용합니다. TCP를 사용하는 IM 채널은 기본적으로 포트 5060을 사용하고 TLS(전송 계층 보안)를 사용하는 IM 채널은 기본적으로 포트 5061을 사용합니다.

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

-PreferredUserName

IM 채널의 기본 사용자 이름을 지정합니다. 값을 설정하지 않으면 기본값은 Username 매개 변수의 값입니다.

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

-PrimaryRetryInterval

재시도 간격을 지정합니다. 서비스는 기본 SMTP 서버 또는 SMS 디바이스로 다시 전환하려고 시도합니다. 기본적으로 간격은 5분입니다.

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

-ReplyTo

알림 전자 메일 메시지의 회신 헤더를 지정합니다.

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

-SCSession

Connection 개체의 배열을 지정합니다. Connection 개체를 가져오려면 Get-SCManagementGroupConnection cmdlet을 사용합니다.

Get-SCManagementGroupConnection cmdlet이 반환하는 것과 같은 관리 그룹에 대한 연결 개체를 입력합니다.

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

-Server

알림을 위해 SMTP 및 IM 채널을 제공하는 서버를 지정합니다.

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

-SipAuthentication

IM 채널에 대한 SIP(세션 시작 프로토콜) 인증 메커니즘(NTLM 또는 Kerberos)을 지정합니다. 기본적으로 SIP 인증은 NTLM 인증을 사용합니다.

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

-SipProtocol

IM 채널에 대한 SIP 전송 프로토콜(TCP 또는 TLS)을 지정합니다. 기본적으로 SIP는 TCP를 전송 프로토콜로 사용합니다.

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

-Sms

cmdlet이 SMS를 사용하여 알림을 보내도록 나타냅니다.

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

-Subject

알림 전자 메일 메시지의 제목 줄을 지정합니다.

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

-UserName

IM의 반환 주소를 지정합니다.

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

-WhatIf

cmdlet을 실행할 경우 발생하는 일을 표시합니다. cmdlet은 실행되지 않습니다.

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

-WorkingDirectory

명령 채널의 작업 디렉터리를 지정합니다. 기본적으로 명령 채널은 %systemdrive%를 작업 디렉터리로 사용합니다.

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

관련 링크

• Get-SCOMNotificationChannel
• Remove-SCOMNotificationChannel