Send-MailMessage

Syntax

Send-MailMessage
    [-Attachments <String[]>]
    [-Bcc <String[]>]
    [[-Body] <String>]
    [-BodyAsHtml]
    [-Encoding <Encoding>]
    [-Cc <String[]>]
    [-DeliveryNotificationOption <DeliveryNotificationOptions>]
    -From <String>
    [[-SmtpServer] <String>]
    [-Priority <MailPriority>]
    [-ReplyTo <String[]>]
    [[-Subject] <String>]
    [-To] <String[]>
    [-Credential <PSCredential>]
    [-UseSsl]
    [-Port <Int32>]
    [<CommonParameters>]

Description

Cmdleten Send-MailMessage skickar ett e-postmeddelande inifrån PowerShell.

Du måste ange en SMTP-server (Simple Mail Transfer Protocol), annars Send-MailMessage misslyckas kommandot. Använd parametern SmtpServer eller ange variabeln $PSEmailServer till en giltig SMTP-server. Värdet som tilldelas är $PSEmailServer standardinställningen för SMTP för PowerShell. Mer information finns i about_Preference_Variables.

Exempel

Exempel 1: Skicka ett e-postmeddelande från en person till en annan

Det här exemplet skickar ett e-postmeddelande från en person till en annan person.

Parametrarna Från, Till och Ämne krävs av Send-MailMessage. I det här exemplet används standardvariabeln $PSEmailServer för SMTP-servern, så parametern SmtpServer behövs inte.

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

Cmdleten Send-MailMessage använder parametern Från för att ange meddelandets avsändare. Parametern Till anger meddelandets mottagare. Parametern Subject använder textsträngen Test mail som meddelande eftersom den valfria body-parametern inte ingår.

Exempel 2: Skicka en bifogad fil

Det här exemplet skickar ett e-postmeddelande med en bifogad fil.

$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

Cmdleten Send-MailMessage använder parametern Från för att ange meddelandets avsändare. Parametern Till anger meddelandets mottagare. Parametern Ämne beskriver innehållet i meddelandet. Brödtextparametern är innehållet i meddelandet.

Parametern Attachments anger filen i den aktuella katalogen som är kopplad till e-postmeddelandet. Parametern Priority anger meddelandet till High prioritet. Parametern DeliveryNotificationOption anger två värden och OnSuccessOnFailure. Avsändaren får e-postaviseringar för att bekräfta att meddelandeleveransen lyckades eller misslyckades. Parametern SmtpServer anger SMTP-servern till smtp.fabrikam.com.

Exempel 3: Skicka e-post till en distributionslista

Det här exemplet skickar ett e-postmeddelande till en distributionslista.

$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

Cmdleten Send-MailMessage använder parametern Från för att ange meddelandets avsändare. Parametern Till anger meddelandets mottagare. Parametern Kopia skickar en kopia av meddelandet till den angivna mottagaren. Parametern Hemlig kopia skickar en blind kopia av meddelandet. En blindkopia är en e-postadress som är dold för de andra mottagarna. Parametern Subject är meddelandet eftersom den valfria body-parametern inte ingår.

Parametern Credential anger att en domänadministratörs autentiseringsuppgifter används för att skicka meddelandet. Parametern UseSsl anger att SSL (Secure Socket Layer) skapar en säker anslutning.

Parametrar

-Attachments

-Bcc

-Body

-BodyAsHtml

-Cc

-Credential

-DeliveryNotificationOption

-Encoding

-From

-Port

-Priority

-ReplyTo

-SmtpServer

-Subject

-To

-UseSsl

Indata

String

Du kan skicka sökvägen och filnamnen för bifogade filer till den här cmdleten.

Utdata

None

Denna cmdlet returnerar inga utdata.

Kommentarer

Cmdleten Send-MailMessage är föråldrad. Mer information finns i Platform Compatibility note DE0005. Den här cmdleten garanterar inte säkra anslutningar till SMTP-servrar.

DE0005 föreslår att du använder bibliotek från tredje part, MailKit. Om du använder Exchange Online kan du använda Send-MgUserMail från Microsoft Graph PowerShell SDK.

Relaterade länkar

• about_Preference_Variables
• Get-Credential