Send-MailMessage

Syntaxis

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

Voorbeelden

Voorbeeld 1: Een e-mailbericht van de ene persoon naar een andere persoon verzenden

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

Voorbeeld 2: Een bijlage verzenden

$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

Voorbeeld 3: E-mail verzenden naar een adressenlijst

$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

Parameters

-Attachments

Hiermee geeft u het pad en de bestandsnamen op van bestanden die moeten worden toegevoegd aan het e-mailbericht. U kunt deze parameter gebruiken of de paden en bestandsnamen doorsluisen om Send-MailMessage.

Parametereigenschappen

Parametersets

-Bcc

Hiermee geeft u de e-mailadressen op die een kopie van de e-mail ontvangen, maar die niet worden vermeld als geadresseerden van het bericht. Voer namen (optioneel) en het e-mailadres in, zoals Name <someone@fabrikam.com>.

Parametereigenschappen

Parametersets

-Body

Hiermee geeft u de inhoud van het e-mailbericht.

Parametereigenschappen

Parametersets

-BodyAsHtml

Hiermee geeft u op dat de waarde van de parameter Body HTML bevat.

Parametereigenschappen

Parametersets

-Cc

Hiermee geeft u de e-mailadressen op waarnaar een carbon copy (CC) van het e-mailbericht wordt verzonden. Voer namen (optioneel) en het e-mailadres in, zoals Name <someone@fabrikam.com>.

Parametereigenschappen

Parametersets

-Credential

Hiermee geeft u een gebruikersaccount op dat gemachtigd is om deze actie uit te voeren. De standaardwaarde is de huidige gebruiker.

Typ een gebruikersnaam, zoals User01 of Domain01\User01. U kunt ook een PSCredential--object invoeren, zoals een object uit de Get-Credential-cmdlet.

Referenties worden opgeslagen in een PSCredential-object en het wachtwoord wordt opgeslagen als een SecureString.

Parametereigenschappen

Parametersets

-DeliveryNotificationOption

Hiermee geeft u de opties voor bezorgingsmeldingen voor het e-mailbericht op. U kunt meerdere waarden opgeven. Geen is de standaardwaarde. De alias voor deze parameter is DNO-.

De bezorgingsmeldingen worden verzonden naar het adres in de parameter Van.

De acceptabele waarden voor deze parameter zijn als volgt:

• None: geen melding.
• OnSuccess: Melden of de levering is geslaagd.
• OnFailure: Melden of de levering mislukt.
• Delay: Melden of de levering is vertraagd.
• Never: Nooit melden.

Deze waarden worden gedefinieerd als een opsomming op basis van vlaggen. U kunt meerdere waarden combineren om meerdere vlaggen in te stellen met behulp van deze parameter. De waarden kunnen worden doorgegeven aan de parameter DeliveryNotification als een matrix met waarden of als een door komma's gescheiden tekenreeks van deze waarden. De cmdlet combineert de waarden met behulp van een binaire OF-bewerking. Het doorgeven van waarden als een matrix is de eenvoudigste optie en u kunt ook tabvoltooiing gebruiken voor de waarden.

Parametereigenschappen

Parametersets

-Encoding

Hiermee geeft u het type codering voor het doelbestand. De standaardwaarde is utf8NoBOM.

De acceptabele waarden voor deze parameter zijn als volgt:

• ascii: maakt gebruik van de codering voor de ASCII-tekenset (7-bits).
• ansi: gebruikt de codering voor de ANSI-codepagina van de huidige cultuur. Deze optie is toegevoegd in PowerShell 7.4.
• bigendianunicode: Codeert in UTF-16-indeling met behulp van de bytevolgorde big-endian.
• bigendianutf32: Codeert in UTF-32-indeling met behulp van de bytevolgorde big-endian.
• oem: maakt gebruik van de standaardcodering voor MS-DOS- en consoleprogramma's.
• unicode: Encodeert in UTF-16-indeling met de little-endian-bytevolgorde.
• utf7: Codeert in UTF-7-formaat.
• utf8: Codeert in de UTF-8-indeling.
• utf8BOM: Codeert in UTF-8-formaat met Byte Order Mark (BOM)
• utf8NoBOM: Codeert in UTF-8-indeling zonder Byte Order Mark (BOM)
• utf32: Codeert in UTF-32-indeling.

Vanaf PowerShell 6.2 staat de parameter Coderings- ook numerieke id's toe van geregistreerde codepagina's (zoals -Encoding 1251) of tekenreeksnamen van geregistreerde codepagina's (zoals -Encoding "windows-1251"). Zie de .NET-documentatie voor Encoding.CodePagevoor meer informatie.

Vanaf PowerShell 7.4 kunt u de Ansi waarde voor de -coderingsparameter gebruiken om de numerieke id voor de ANSI-codepagina van de huidige cultuur door te geven zonder deze handmatig op te geven.

Parametereigenschappen

Parametersets

-From

De parameter From is vereist. Met deze parameter geeft u het e-mailadres van de afzender op. Voer een naam (optioneel) en e-mailadres in, zoals Name <someone@fabrikam.com>.

Parametereigenschappen

Parametersets

-Port

Hiermee geeft u een alternatieve poort op de SMTP-server. De standaardwaarde is 25, de standaard SMTP-poort.

Parametereigenschappen

Parametersets

-Priority

Hiermee geeft u de prioriteit van het e-mailbericht. Normaal is de standaardwaarde. De acceptabele waarden voor deze parameter zijn Normaal, Hoog en Laag.

Parametereigenschappen

Parametersets

-ReplyTo

Hiermee geeft u extra e-mailadressen op (behalve het Van-adres) dat moet worden gebruikt om dit bericht te beantwoorden. Voer namen (optioneel) en het e-mailadres in, zoals Name <someone@fabrikam.com>.

Deze parameter is geïntroduceerd in PowerShell 6.2.

Parametereigenschappen

Parametersets

-SmtpServer

Hiermee geeft u de naam op van de SMTP-server die het e-mailbericht verzendt.

De standaardwaarde is de waarde van de $PSEmailServer voorkeursvariabele. Als de voorkeursvariabele niet is ingesteld en deze parameter niet wordt gebruikt, mislukt de opdracht Send-MailMessage.

Parametereigenschappen

Parametersets

-Subject

De parameter Onderwerp is niet vereist. Met deze parameter wordt het onderwerp van het e-mailbericht opgegeven.

Parametereigenschappen

Parametersets

-To

De parameter Aan is vereist. Met deze parameter geeft u het e-mailadres van de geadresseerde op. Voer namen (optioneel) en het e-mailadres in, zoals Name <someone@fabrikam.com>.

Parametereigenschappen

Parametersets

-UseSsl

Het SSL-protocol (Secure Sockets Layer) wordt gebruikt om een beveiligde verbinding tot stand te brengen met de externe computer om e-mail te verzenden. SSL wordt standaard niet gebruikt.

Parametereigenschappen

Parametersets

CommonParameters

Invoerwaarden

String

Uitvoerwaarden

None

Notities

Verwante koppelingen

• over_Voorkeurs_Variabelen
• Get-Credential