Send-MailMessage
E-mailt küld.
Syntax
All
Send-MailMessage
[-To] <string[]>
[-Subject] <string>
[[-Body] <string>]
[[-SmtpServer] <string>]
-From <string>
[-Attachments <string[]>]
[-Bcc <string[]>]
[-BodyAsHtml]
[-Encoding <Encoding>]
[-Cc <string[]>]
[-DeliveryNotificationOption <DeliveryNotificationOptions>]
[-Priority <MailPriority>]
[-Credential <pscredential>]
[-UseSsl]
[-Port <int>]
[<CommonParameters>]
Description
A Send-MailMessage parancsmag e-mailt küld a PowerShellből.
Meg kell adnia egy SMTP-kiszolgálót, vagy a Send-MailMessage parancs meghiúsul. Használja az SmtpServer paramétert, vagy állítsa be a $PSEmailServer változót érvényes SMTP-kiszolgálóra.
Az $PSEmailServer hozzárendelt érték a PowerShell alapértelmezett SMTP-beállítása. További információ a about_Preference_Variablescímű részben található.
Példák
1. példa: E-mail küldése egy személytől egy másik személynek
Ez a példa egy e-mailt küld egy személytől egy másik személynek.
A a, a aés a Tárgy paramétereket Send-MailMessage. Ez a példa az SMTP-kiszolgáló alapértelmezett $PSEmailServer változót használja, így az SmtpServer paraméterre nincs szükség.
Send-MailMessage -From 'User01 <user01@fabrikam.com>' -To 'User02 <user02@fabrikam.com>' -Subject 'Test mail'
A Send-MailMessage parancsmag a From paramétert használja az üzenet feladójának megadásához. A To paraméter határozza meg az üzenet címzettjét. A Tárgy paraméter a E-mail tesztelése szöveges sztringet használja üzenetként, mert az opcionális Törzs paraméter nem szerepel benne.
2. példa: Melléklet küldése
Ez a példa egy melléklettel ellátott e-mailt küld.
Send-MailMessage -From 'User01 <user01@fabrikam.com>' -To 'User02 <user02@fabrikam.com>', 'User03 <user03@fabrikam.com>' -Subject 'Sending the Attachment' -Body "Forgot to send the attachment. Sending now." -Attachments .\data.csv -Priority High -DeliveryNotificationOption OnSuccess, OnFailure -SmtpServer 'smtp.fabrikam.com'
A Send-MailMessage parancsmag a From paramétert használja az üzenet feladójának megadásához. A Címzett paraméter határozza meg az üzenet címzettjeinek nevét. A Tárgy paraméter az üzenet tartalmát írja le. A Törzs paraméter az üzenet tartalma.
A Mellékletek paraméter az e-mailhez csatolt aktuális könyvtárban lévő fájlt adja meg. A
3. példa: E-mail küldése levelezőlistára
Ez a példa e-mailt küld egy levelezőlistának.
Send-MailMessage -From 'User01 <user01@fabrikam.com>' -To 'ITGroup <itdept@fabrikam.com>' -Cc 'User02 <user02@fabrikam.com>' -Bcc 'ITMgr <itmgr@fabrikam.com>' -Subject "Don't forget today's meeting!" -Credential domain01\admin01 -UseSsl
A Send-MailMessage parancsmag a From paramétert használja az üzenet feladójának megadásához. A Címzett paraméter határozza meg az üzenet címzettjeinek nevét. A Másolatot kap paraméter elküldi az üzenet másolatát a megadott címzettnek. A Titkos másolat paraméter vakmásolatot küld az üzenetről. A vakmásolat egy e-mail-cím, amely elrejtve van a többi címzett elől. A Tárgy paraméter az üzenet, mert az opcionális Törzs paraméter nem szerepel benne.
A Hitelesítő adatok paraméter megadja, hogy a rendszer a tartományi rendszergazda hitelesítő adatait használja az üzenet küldéséhez. A UseSsl paraméter azt határozza meg, hogy a Secure Socket Layer (SSL) biztonságos kapcsolatot hoz létre.
Paraméterek
-Attachments
Megadja az e-mailhez csatolandó fájlok elérési útját és fájlneveit. Ezt a paramétert használhatja, vagy az elérési utakat és fájlneveket a Send-MailMessage.
Paramétertulajdonságok
| Típus: | String[] |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
| Aliasok: | PsPath |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | True |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-Bcc
Megadja azokat az e-mail-címeket, amelyek megkapják a levél másolatát, de nem szerepelnek az üzenet címzettjei között. Adja meg a neveket (nem kötelező) és az e-mail-címet, például Name <someone@fabrikam.com>.
Paramétertulajdonságok
| Típus: | String[] |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-Body
Megadja az e-mail tartalmát.
Paramétertulajdonságok
| Típus: | String |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | 2 |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-BodyAsHtml
Megadja, hogy a törzs paraméter értéke HTML-t tartalmaz.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
| Aliasok: | UGYAN |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-Cc
Megadja azokat az e-mail-címeket, amelyekre az e-mail másolatot (CC) küldi a rendszer. Adja meg a neveket (nem kötelező) és az e-mail-címet, például Name <someone@fabrikam.com>.
Paramétertulajdonságok
| Típus: | String[] |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-Credential
A művelet végrehajtásához engedéllyel rendelkező felhasználói fiókot ad meg. Az alapértelmezett az aktuális felhasználó.
Írjon be egy felhasználónevet, például User01 vagy Domain01\User01. Vagy írjon be egy PSCredential objektumot, például egyet a Get-Credential parancsmagból.
Paramétertulajdonságok
| Típus: | PSCredential |
| Alapértelmezett érték: | Current user |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-DeliveryNotificationOption
Megadja az e-mail kézbesítési értesítési beállításait. Több értéket is megadhat. Egyik sem az alapértelmezett érték. A paraméter aliasa DNO.
A kézbesítési értesítéseket a rendszer a Feladó paraméter címére küldi.
A paraméter elfogadható értékei a következők:
- Nincs: Nincs értesítés.
- OnSuccess: Értesítést küld, ha a kézbesítés sikeres.
- OnFailure: Értesítést küld, ha a kézbesítés sikertelen.
- Késleltetési: Értesítést küld, ha a kézbesítés késik.
- Soha ne: Soha ne értesítsen.
Paramétertulajdonságok
| Típus: | DeliveryNotificationOptions |
| Alapértelmezett érték: | None |
| Elfogadott értékek: | None, OnSuccess, OnFailure, Delay, Never |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
| Aliasok: | DNO |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-Encoding
Megadja a célfájl kódolási típusát. Az alapértelmezett érték a következő: Alapértelmezett.
A paraméter elfogadható értékei a következők:
- ASCII ASCII (7 bites) karakterkészletet használ.
- BigEndianUnicode UTF-16-ot használ a big-endian bájtsorrenddel.
- Alapértelmezett A rendszer aktív kódlapjának (általában ANSI) megfelelő kódolást használja.
- OEM A rendszer aktuális OEM-kódlapjának megfelelő kódolást használja.
- Unicode UTF-16-ot használ a kis-endian bájtsorrenddel.
- UTF7 UTF-7-et használ.
- UTF8 UTF-8-at használ.
- UTF32 UTF-32-t használ a kis végű bájtsorrenddel.
Paramétertulajdonságok
| Típus: | Encoding |
| Alapértelmezett érték: | Default |
| Elfogadott értékek: | ASCII, BigEndianUnicode, Default, OEM, Unicode, UTF7, UTF8, UTF32 |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
| Aliasok: | BE |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-From
A From paraméterre van szükség. Ez a paraméter a feladó e-mail-címét adja meg. Adjon meg egy nevet (nem kötelező) és e-mail-címet, például Name <someone@fabrikam.com>.
Paramétertulajdonságok
| Típus: | String |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | True |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-Port
Alternatív portot ad meg az SMTP-kiszolgálón. Az alapértelmezett érték 25, amely az alapértelmezett SMTP-port.
Paramétertulajdonságok
| Típus: | Int32 |
| Alapértelmezett érték: | 25 |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-Priority
Megadja az e-mail prioritását. A normál érték az alapértelmezett érték. A paraméter elfogadható értékei a Normál, a Magas és az Alacsony.
Paramétertulajdonságok
| Típus: | MailPriority |
| Alapértelmezett érték: | Normal |
| Elfogadott értékek: | Normal, High, Low |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-SmtpServer
Megadja az e-mailt küldő SMTP-kiszolgáló nevét.
Az alapértelmezett érték a $PSEmailServer beállítási változó értéke. Ha a beállítási változó nincs beállítva, és nem használja ezt a paramétert, a Send-MailMessage parancs meghiúsul.
Paramétertulajdonságok
| Típus: | String |
| Alapértelmezett érték: | $PSEmailServer |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
| Aliasok: | Számítógépnév |
Paraméterkészletek
(All)
| Position: | 3 |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-Subject
A Tárgy paraméter megadása kötelező. Ez a paraméter határozza meg az e-mail tárgyát.
Paramétertulajdonságok
| Típus: | String |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
| Aliasok: | helyettes |
Paraméterkészletek
(All)
| Position: | 1 |
| Kötelező: | True |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-To
A paraméter ,) kell elválasztani. Adja meg a neveket (nem kötelező) és az e-mail-címet, például Name <someone@fabrikam.com>.
Paramétertulajdonságok
| Típus: | String[] |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | 0 |
| Kötelező: | True |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-UseSsl
A Secure Sockets Layer (SSL) protokoll használatával biztonságos kapcsolatot létesíthet a távoli számítógéppel az e-mailek küldéséhez. Alapértelmezés szerint az SSL nem használatos.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
CommonParameters
Ez a parancsmag a következő gyakori paramétereket támogatja: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction és -WarningVariable. További információért lásd about_CommonParameters.
Bevitelek
String
A mellékletek elérési útját és fájlneveit a Send-MailMessage.
Kimenetek
None
Ez a parancsmag nem hoz létre kimenetet.