Send-MailMessage

Modul:

Microsoft.PowerShell.Utility Module

E-mailt küld.

Syntax

All

Send-MailMessage
    [[-Body] <String>]
    [[-SmtpServer] <String>]
    [[-Subject] <String>]
    [-To] <String[]>
    -From <String>
    [-Attachments <String[]>]
    [-Bcc <String[]>]
    [-BodyAsHtml]
    [-Encoding <Encoding>]
    [-Cc <String[]>]
    [-DeliveryNotificationOption <DeliveryNotificationOptions>]
    [-Priority <MailPriority>]
    [-ReplyTo <String[]>]
    [-Credential <PSCredential>]
    [-UseSsl]
    [-Port <Int32>]
    [<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ó.

Figyelmeztetés

A Send-MailMessage parancsmag elavult. Ez a parancsmag nem garantálja az SMTP-kiszolgálókhoz való biztonságos csatlakozást. Bár a PowerShellben nem érhető el azonnali csere, javasoljuk, hogy ne használja Send-MailMessage. További információ: Platformkompatibilitási megjegyzés DE0005.

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.

$sendMailMessageSplat = @{
    From = 'User01 <user01@fabrikam.com>'
    To = 'User02 <user02@fabrikam.com>'
    Subject = 'Test mail'
}
Send-MailMessage @sendMailMessageSplat

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 Test mail 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.

$sendMailMessageSplat = @{
    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'
}
Send-MailMessage @sendMailMessageSplat

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 Prioritás paraméter prioritásra állítja az High üzenetet. A DeliveryNotificationOption paraméter két értéket OnSuccessOnFailureés . A feladó e-mail-értesítéseket kap, hogy megerősítse az üzenetkézbesítés sikerességét vagy sikertelenségét. Az SmtpServer paraméter a következőre állítja az SMTP-kiszolgálót smtp.fabrikam.com: .

3. példa: E-mail küldése levelezőlistára

Ez a példa e-mailt küld egy levelezőlistának.

$sendMailMessageSplat = @{
    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 = $true
}
Send-MailMessage @sendMailMessageSplat

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:	True
Fennmaradó argumentumokból származó érték:	False

-Bcc

Megadja azokat az e-mail-címeket, amelyek megkapják az e-mail 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:	True
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:	True
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:	True
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:	True
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.

A hitelesítő adatokat egy PSCredential objektum tárolja, a jelszó pedig SecureString.

Megjegyzés:

További információért a SecureString adatvédelemről lásd: Mennyire biztonságos a SecureString?.

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:	True
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:

• None: Nincs értesítés.
• OnSuccess: Értesítést kérek, ha a kézbesítés sikeres.
• OnFailure: Értesítést kérek, ha a kézbesítés sikertelen.
• Delay: Értesítést kérek, ha a kézbesítés késik.
• Never: Soha ne értesítsen.

Ezek az értékek jelölőalapú számbavételként vannak definiálva. Több érték kombinálásával több jelölőt is beállíthat ezzel a paraméterrel. Az értékek átadhatók a DeliveryNotification paraméternek értéktömbként vagy az értékek vesszővel elválasztott sztringjeként. A parancsmag bináris VAGY művelettel egyesíti az értékeket. Az értékek tömbként való átadása a legegyszerűbb lehetőség, és lehetővé teszi a tabulátorkiegészítés használatát is az értékeken.

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:	True
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 utf8NoBOM.

A paraméter elfogadható értékei a következők:

• ascii: Az ASCII (7 bites) karakterkészlet kódolását használja.
• ansi: Az aktuális kultúra ANSI-kódlapjának kódolását használja. Ez a beállítás a PowerShell 7.4-ben lett hozzáadva.
• bigendianunicode: Az UTF-16 formátumú kódolást a big-endian bájtsorrend alkalmazásával végzi.
• bigendianutf32: UTF-32 formátumban kódol nagyvégű bájtsorrend használatával.
• oem: Az alapértelmezett kódolást használja MS-DOS és konzolprogramokhoz.
• unicode: Az UTF-16 formátumban kódol kis végű bájtsorrend használatával.
• utf7: UTF-7 formátumban kódol.
• utf8: UTF-8 formátumban kódol.
• utf8BOM: UTF-8 formátumban kódolódik bájt sorrendi jel (BOM) használatával
• utf8NoBOM: UTF-8 formátumban kódol byte order mark (BOM) nélkül
• utf32: UTF-32 formátumban kódol.

A PowerShell 6.2-től kezdődően a Kódolás paraméter lehetővé teszi a regisztrált kódlapok (például -Encoding 1251) numerikus azonosítóit vagy a regisztrált kódlapok sztringneveit (például -Encoding "windows-1251"). További információt a Encoding.CodePage.NET-dokumentációjában talál.

A PowerShell 7.4-től kezdve a Ansi paraméter értékével anélkül adhat meg numerikus azonosítót az aktuális kultúra ANSI-kódlapjához, hogy manuálisan kellene megadnia.

Megjegyzés:

UTF-7* már nem ajánlott. PowerShell 7.1-től kezdve figyelmeztetés jelenik meg, ha utf7-et ad meg a kódolás paraméterhez.

Paramétertulajdonságok

Típus:	Encoding
Alapértelmezett érték:	ASCII
Elfogadott értékek:	ASCII, BigEndianUnicode, BigEndianUTF32, OEM, Unicode, UTF7, UTF8, UTF8BOM, UTF8NoBOM, 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:	True
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:	True
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:	True
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:	True
Fennmaradó argumentumokból származó érték:	False

-ReplyTo

További e-mail-címeket (a Feladó címtől eltérő) ad meg az üzenet megválaszolásához. Adja meg a neveket (nem kötelező) és az e-mail-címet, például Name <someone@fabrikam.com>.

Ez a paraméter a PowerShell 6.2-ben lett bevezetve.

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:	True
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:	True
Fennmaradó argumentumokból származó érték:	False

-Subject

A Tárgy paraméter nem szükséges. 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ő:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	True
Fennmaradó argumentumokból származó érték:	False

-To

A paraméter szükséges. Ez a paraméter a címzett e-mail-címét adja meg. 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:	True
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:	True
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 parancsmagba a mellékletek elérési útját és fájlneveit is beszűkítheti.

Kimenetek

None

Ez a parancsmag nem ad vissza kimenetet.

Jegyzetek

A Send-MailMessage parancsmag elavult. További információ: Platformkompatibilitási megjegyzés DE0005. Ez a parancsmag nem garantálja az SMTP-kiszolgálókhoz való biztonságos csatlakozást.

A DE0005 a MailKit harmadik féltől származó kódtár használatát javasolja. Ha Exchange Online-t használ, használhatja a Send-MgUserMailt a Microsoft Graph PowerShell SDK-ból.

Kapcsolódó hivatkozások

• Információk_a_Beállítási_Változókról
• Get-Credential