Dela via

Send-MailMessage

  • Referens
Modul:
Microsoft.PowerShell.Utility

Skickar ett e-postmeddelande.

Syntax

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

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

Du måste ange en SMTP-server (Simple Mail Transfer Protocol) eller så misslyckas kommandot Send-MailMessage. Använd parametern SmtpServer eller ange variabeln $PSEmailServer till en giltig SMTP-server. Värdet som tilldelas $PSEmailServer är 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 From, Tooch Subject krävs av Send-MailMessage. I det här exemplet används standardvariabeln $PSEmailServer för SMTP-servern, så parametern SmtpServer behövs inte.

Send-MailMessage -From 'User01 <user01@fabrikam.com>' -To 'User02 <user02@fabrikam.com>' -Subject 'Test mail'

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 parametern Body inte ingår.

Exempel 2: Skicka en bifogad fil

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

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'

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

Parametern Attachments anger filen i den aktuella katalogen som är kopplad till e-postmeddelandet. Parametern Priority anger meddelandet till hög prioritet. Parametern -DeliveryNotificationOption anger två värden, OnSuccess och OnFailure. 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 e-postlista

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

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

Cmdleten Send-MailMessage använder parametern Från för att ange meddelandets avsändare. Parametern Till anger meddelandets mottagare. Parametern Cc skickar en kopia av meddelandet till den angivna mottagaren. Parametern Bcc skickar en blindkopia av meddelandet. En blindkopia är en e-postadress som är dold för de andra mottagarna. Parametern Subject är meddelandet eftersom den valfria parametern Body 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

Anger sökvägen och filnamnen för filer som ska kopplas till e-postmeddelandet. Du kan använda den här parametern eller skicka sökvägar och filnamn till att Send-MailMessage.

Typ:String[]
Alias:PsPath
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-Bcc

Anger de e-postadresser som tar emot en kopia av e-postmeddelandet men som inte visas som mottagare av meddelandet. Ange namn (valfritt) och e-postadressen, till exempel Name <someone@fabrikam.com>.

Typ:String[]
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Body

Anger innehållet i e-postmeddelandet.

Typ:String
Position:2
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-BodyAsHtml

Anger att värdet för parametern Body innehåller HTML.

Typ:SwitchParameter
Alias:BAH
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Cc

Anger de e-postadresser som en kopia av e-postmeddelandet skickas till. Ange namn (valfritt) och e-postadressen, till exempel Name <someone@fabrikam.com>.

Typ:String[]
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Credential

Anger ett användarkonto som har behörighet att utföra den här åtgärden. Standardvärdet är den aktuella användaren.

Ange ett användarnamn, till exempel User01 eller Domain01\User01. Eller ange ett PSCredential- objekt, till exempel ett från Get-Credential-cmdleten.

Typ:PSCredential
Position:Named
Standardvärde:Current user
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-DeliveryNotificationOption

Anger leveransmeddelandealternativen för e-postmeddelandet. Du kan ange flera värden. Ingen är standardvärdet. Aliaset för den här parametern är DNO.

Leveransmeddelandena skickas till adressen i parametern From.

Godkända värden för den här parametern är följande:

  • Ingen: Inget meddelande.
  • OnSuccess: Meddela om leveransen lyckas.
  • OnFailure: Meddela om leveransen misslyckas.
  • Fördröjning: Meddela om leveransen är försenad.
  • Meddela aldrig: Meddela aldrig.
Typ:DeliveryNotificationOptions
Alias:DNO
Godkända värden:None, OnSuccess, OnFailure, Delay, Never
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Encoding

Anger typen av kodning för målfilen. Standardvärdet är Standard.

Godkända värden för den här parametern är följande:

  • ASCII Använder ASCII-teckenuppsättning (7-bitars).
  • BigEndianUnicode använder UTF-16 med den stora byteordningen.
  • Standard Använder kodningen som motsvarar systemets aktiva kodsida (vanligtvis ANSI).
  • OEM- Använder kodningen som motsvarar systemets aktuella OEM-kodsida.
  • Unicode- använder UTF-16 med lite endiansk byteordning.
  • UTF7 använder UTF-7.
  • UTF8 använder UTF-8.
  • UTF32- använder UTF-32 med lite endiansk byteordning.
Typ:Encoding
Alias:BE
Godkända värden:ASCII, BigEndianUnicode, Default, OEM, Unicode, UTF7, UTF8, UTF32
Position:Named
Standardvärde:Default
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-From

Parametern Från krävs. Den här parametern anger avsändarens e-postadress. Ange ett namn (valfritt) och en e-postadress, till exempel Name <someone@fabrikam.com>.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Port

Anger en alternativ port på SMTP-servern. Standardvärdet är 25, vilket är smtp-standardporten.

Typ:Int32
Position:Named
Standardvärde:25
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Priority

Anger prioriteten för e-postmeddelandet. Normal är standardvärdet. De acceptabla värdena för den här parametern är Normal, Hög och Låg.

Typ:MailPriority
Godkända värden:Normal, High, Low
Position:Named
Standardvärde:Normal
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-SmtpServer

Anger namnet på SMTP-servern som skickar e-postmeddelandet.

Standardvärdet är värdet för $PSEmailServer-inställningsvariabeln. Om inställningsvariabeln inte har angetts och den här parametern inte används misslyckas kommandot Send-MailMessage.

Typ:String
Alias:ComputerName
Position:3
Standardvärde:$PSEmailServer
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Subject

Parametern Subject krävs. Den här parametern anger ämnet för e-postmeddelandet.

Typ:String
Alias:sub
Position:1
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-To

Parametern Till krävs. Den här parametern anger mottagarens e-postadress. Om det finns flera mottagare separerar du deras adresser med kommatecken (,). Ange namn (valfritt) och e-postadressen, till exempel Name <someone@fabrikam.com>.

Typ:String[]
Position:0
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-UseSsl

SSL-protokollet (Secure Sockets Layer) används för att upprätta en säker anslutning till fjärrdatorn för att skicka e-post. Som standard används inte SSL.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

Indata

String

Du kan skicka sökvägen och filnamnen för bifogade filer till Send-MailMessage.

Utdata

None

Den här cmdleten genererar inga utdata.