Send-MailMessage
전자 메일 메시지를 보냅니다.
구문
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 |
기본값 |
현재 사용자 |
파이프라인 입력 적용 여부 |
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 매개 변수를 사용합니다.