전자 메일 메시지를 보냅니다.

구문

Send-MailMessage [-To] <string[]> [-Subject] <string> -From <string> [[-Body] <string>] [[-SmtpServer] <string>] [-Attachments <string[]>] [-Bcc <string[]>] [-BodyAsHtml] [-Cc <string[]>] [-Credential <PSCredential>] [-DeliveryNotificationOption {<None> | <OnSuccess> | <OnFailure> | <Delay> | <Never>}] [-Encoding <Encoding>] [-Priority {<Normal> | <Low> | <High>}] [-UseSsl] [<CommonParameters>]

설명

Send-MailMessage cmdlet은 Windows PowerShell 내에서 전자 메일 메시지를 보냅니다.

매개 변수

-Attachments <string[]>

전자 메일 메시지에 첨부할 파일의 경로와 파일 이름을 지정합니다. 이 매개 변수를 사용하거나 경로 및 파일 이름을 Send-MailMessage로 파이프할 수 있습니다.

필수 여부

false

위치

named

기본값

파이프라인 입력 적용 여부

true (ByValue)

와일드카드 문자 적용 여부

false

-Bcc <string[]>

메일의 복사본을 받지만 메시지 수신자로 나열되어 있지 않은 전자 메일 주소를 지정합니다. 이름(선택 사항) 및 전자 메일 주소를 입력합니다(예: "Name <someone@example.com>").

필수 여부

false

위치

named

기본값

없음

파이프라인 입력 적용 여부

false

와일드카드 문자 적용 여부

false

-Body <string>

전자 메일 메시지의 본문(내용)을 지정합니다.

필수 여부

false

위치

3

기본값

없음

파이프라인 입력 적용 여부

false

와일드카드 문자 적용 여부

false

-BodyAsHtml

Body 매개 변수 값에 HTML이 포함되어 있음을 나타냅니다.

필수 여부

false

위치

named

기본값

False

파이프라인 입력 적용 여부

false

와일드카드 문자 적용 여부

false

-Cc <string[]>

전자 메일 메시지의 CC(참조)를 보낼 전자 메일 주소를 지정합니다. 이름(선택 사항) 및 전자 메일 주소를 입력합니다(예: "Name <someone@example.com>").

필수 여부

false

위치

named

기본값

없음

파이프라인 입력 적용 여부

false

와일드카드 문자 적용 여부

false

-Credential <PSCredential>

이 작업을 수행할 수 있는 권한을 가진 사용자 계정을 지정합니다. 기본값은 현재 사용자입니다.

"User01" 또는 "Domain01\User01"과 같은 사용자 이름을 입력합니다. 또는 Get-Credential cmdlet에서 반환된 개체와 같은 PSCredential 개체를 입력합니다.

필수 여부

false

위치

named

기본값

Current user

파이프라인 입력 적용 여부

false

와일드카드 문자 적용 여부

false

-DeliveryNotificationOption <DeliveryNotificationOptions>

전자 메일 메시지에 대한 배달 알림 옵션을 지정합니다. 값을 여러 개 지정할 수 있습니다. 기본값은 "None"입니다. 이 매개 변수의 별칭은 "dno"입니다.

배달 알림은 전자 메일 메시지에 포함되어 To 매개 변수 값에 지정된 주소로 전송됩니다.

유효한 값은 다음과 같습니다.

-- None: 알림이 없습니다.

-- OnSuccess: 배달에 성공하면 알립니다.

-- OnFailure: 배달에 실패하면 알립니다.

-- Delay: 배달이 지연되면 알립니다.

-- Never: 알리지 않습니다.

필수 여부

false

위치

named

기본값

없음

파이프라인 입력 적용 여부

false

와일드카드 문자 적용 여부

false

-Encoding <Encoding>

본문과 제목에 사용되는 인코딩을 지정합니다. 유효한 값은 ASCII, UTF8, UTF7, UTF32, Unicode, BigEndianUnicode, Default 및 OEM입니다. 기본값은 ASCII입니다.

필수 여부

false

위치

named

기본값

ASCII

파이프라인 입력 적용 여부

false

와일드카드 문자 적용 여부

false

-From <string>

메일을 보내는 사람의 주소를 지정합니다. 이름(선택 사항) 및 전자 메일 주소를 입력합니다(예: "Name <someone@example.com>"). 이 매개 변수는 필수 사항입니다.

필수 여부

true

위치

named

기본값

없음

파이프라인 입력 적용 여부

false

와일드카드 문자 적용 여부

false

-Priority <MailPriority>

전자 메일 메시지의 우선 순위를 지정합니다. 이 매개 변수에 유효한 값은 Normal, High 및 Low입니다. 기본값은 Normal입니다.

필수 여부

false

위치

named

기본값

Normal.

파이프라인 입력 적용 여부

false

와일드카드 문자 적용 여부

false

-SmtpServer <string>

전자 메일 메시지를 보내는 SMTP 서버 이름을 지정합니다.

기본값은 $PSEmailServer 기본 설정 변수의 값입니다. 기본 설정 변수가 설정되어 있지 않고 이 매개 변수가 생략되면 명령이 실패합니다.

필수 여부

false

위치

4

기본값

$PSEmailServer

파이프라인 입력 적용 여부

false

와일드카드 문자 적용 여부

false

-Subject <string>

전자 메일 메시지의 제목을 지정합니다. 이 매개 변수는 필수 사항입니다.

필수 여부

true

위치

2

기본값

없음

파이프라인 입력 적용 여부

false

와일드카드 문자 적용 여부

false

-To <string[]>

메일을 받는 사람의 주소를 지정합니다. 이름(선택 사항) 및 전자 메일 주소를 입력합니다(예: "Name <someone@example.com>"). 이 매개 변수는 필수 사항입니다.

필수 여부

true

위치

1

기본값

없음

파이프라인 입력 적용 여부

false

와일드카드 문자 적용 여부

false

-UseSsl

SSL(Secure Sockets Layer) 프로토콜을 사용하여 원격 컴퓨터에 연결하여 메일을 보냅니다. 기본적으로 SSL은 사용되지 않습니다.

필수 여부

false

위치

named

기본값

False

파이프라인 입력 적용 여부

false

와일드카드 문자 적용 여부

false

<CommonParameters>

이 cmdlet은 -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, -OutVariable 등의 일반 매개 변수를 지원합니다. 자세한 내용은 about_Commonparameters.

입력 및 출력

입력 유형은 cmdlet으로 파이프할 수 있는 개체의 유형입니다. 반환 유형은 cmdlet에서 반환되는 개체의 유형입니다.

입력

System.String

첨부 파일의 경로 및 파일 이름을 Send-MailMessage로 파이프할 수 있습니다.

출력

없음

이 cmdlet은 어떠한 출력도 생성하지 않습니다.

예 1

C:\PS>send-mailmessage -to "User01 <user01@example.com>" -from "User02 <user02@example.com>" -subject "Test mail"

설명
-----------
이 명령은 전자 메일 메시지를 User01에서 User02로 보냅니다. 

메일 메시지에는 필수 사항인 제목이 있지만 선택 사항인 본문은 없습니다. 또한 SmtpServer 매개 변수가 지정되지 않았으므로 Send-MailMessage는 SMTP 서버로 $PSEmailServer 기본 설정 변수의 값을 사용합니다.






예 2

C:\PS>send-mailmessage -from "User01 <user01@example.com>" -to "User02 <user02@example.com>", "User03 <user03@example.com>" -subject "Sending the Attachment" -body "Forgot to send the attachment. Sending now." -Attachment "data.csv" -priority High -dno onSuccess, onFailure -smtpServer smtp.fabrikam.com

설명
-----------
이 명령은 첨부 파일이 있는 전자 메일 메시지를 User01에서 다른 두 사용자에게 보냅니다. 

이 명령은 우선 순위 값으로 "High"를 지정하고 전자 메일 메시지가 배달되거나 배달에 실패한 경우 전자 메일로 배달 알림을 보내줄 것을 요청합니다.






예 3

C:\PS>send-mailmessage -to "User01 <user01@example.com>" -from "ITGroup <itdept@example.com>" -cc "User02 <user02@example.com>" -bcc ITMgr <itmgr@example.com> -subject "Don't forget today's meeting!" -credential domain01\admin01 -useSSL

설명
-----------
이 명령은 전자 메일 메시지를 User01에서 ITGroup 메일 그룹으로 보내고 CC(참조)를 User02에게, BCC(숨은 참조)를 IT 관리자(ITMgr)에게 보냅니다.

이 명령은 도메인 관리자의 자격 증명 및 UseSSL 매개 변수를 사용합니다.









목차