Send-MailMessage

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

Exempel

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

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

Exempel 2: Skicka 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

Exempel 3: Skicka e-post till en e-postlista

$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

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.

Parameteregenskaper

Parameteruppsättningar

-Bcc

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

Parameteregenskaper

Parameteruppsättningar

-Body

Anger innehållet i e-postmeddelandet.

Parameteregenskaper

Parameteruppsättningar

-BodyAsHtml

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

Parameteregenskaper

Parameteruppsättningar

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

Parameteregenskaper

Parameteruppsättningar

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

Autentiseringsuppgifter lagras i ett PSCredential--objekt och lösenordet lagras som en SecureString-.

Parameteregenskaper

Parameteruppsättningar

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

• None: Inget meddelande.
• OnSuccess: Meddela om leveransen lyckas.
• OnFailure: Meddela om leveransen misslyckas.
• Delay: Meddela om leveransen är försenad.
• Never: Meddela aldrig.

Dessa värden definieras som en flaggbaserad uppräkning. Du kan kombinera flera värden för att ange flera flaggor med hjälp av den här parametern. Värdena kan skickas till parametern DeliveryNotification som en matris med värden eller som en kommaavgränsad sträng med dessa värden. Cmdleten kombinerar värdena med hjälp av en binär-OR-åtgärd. Att skicka värden som en matris är det enklaste alternativet och du kan även använda tab-completion på värdena.

Parameteregenskaper

Parameteruppsättningar

-Encoding

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

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

• ascii: Använder kodningen för ASCII-teckenuppsättningen (7-bitars).
• ansi: Använder kodningen för den aktuella kulturens ANSI-kodsida. Det här alternativet lades till i PowerShell 7.4.
• bigendianunicode: Kodar i UTF-16-format med hjälp av storstavelseordningen.
• bigendianutf32: Kodar i UTF-32-format med big-endian-byteordning.
• oem: Använder standardkodning för MS-DOS- och konsolprogram.
• unicode: Kodar i UTF-16-format med hjälp av lite endiansk byteordning.
• utf7: Kodar i UTF-7-format.
• utf8: Kodar i UTF-8-format.
• utf8BOM: Kodar i UTF-8-format med Byte Order Mark (BOM)
• utf8NoBOM: Kodar i UTF-8-format utan Byte Order Mark (BOM)
• utf32: Kodar i UTF-32-format.

Från och med PowerShell 6.2 tillåter parametern Kodning även numeriska ID:n för registrerade kodsidor (till exempel -Encoding 1251) eller strängnamn för registrerade kodsidor (till exempel -Encoding "windows-1251"). Mer information finns i .NET-dokumentationen för Encoding.CodePage.

Från och med PowerShell 7.4 kan du använda värdet Ansi för parametern Kodning för att skicka det numeriska ID:t för den aktuella kulturens ANSI-kodsida utan att behöva ange det manuellt.

Parameteregenskaper

Parameteruppsättningar

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

Parameteregenskaper

Parameteruppsättningar

-Port

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

Parameteregenskaper

Parameteruppsättningar

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

Parameteregenskaper

Parameteruppsättningar

-ReplyTo

Anger ytterligare e-postadresser (förutom Från-adressen) som ska användas för att svara på det här meddelandet. Ange namn (valfritt) och e-postadressen, till exempel Name <someone@fabrikam.com>.

Den här parametern introducerades i PowerShell 6.2.

Parameteregenskaper

Parameteruppsättningar

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

Parameteregenskaper

Parameteruppsättningar

-Subject

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

Parameteregenskaper

Parameteruppsättningar

-To

Parametern Till krävs. Den här parametern anger mottagarens e-postadress. Ange namn (valfritt) och e-postadressen, till exempel Name <someone@fabrikam.com>.

Parameteregenskaper

Parameteruppsättningar

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

Parameteregenskaper

Parameteruppsättningar

CommonParameters

Indata

String

Utdata

None

Kommentarer

Relaterade länkar

• Om inställningsvariabler
• Get-Credential