Send-MailMessage

  • Başvuru
Modül:
Microsoft.PowerShell.Utility

E-posta iletisi gönderir.

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

Cmdlet, Send-MailMessage PowerShell'in içinden bir e-posta iletisi gönderir.

Basit Posta Aktarım Protokolü (SMTP) sunucusu belirtmeniz gerekir, aksi durumda Send-MailMessage komut başarısız olur. SmtpServer parametresini kullanın veya değişkeni geçerli bir SMTP sunucusuna ayarlayın$PSEmailServer. Atanan $PSEmailServer değer, PowerShell için varsayılan SMTP ayarıdır. Daha fazla bilgi için bkz. about_Preference_Variables.

Uyarı

Send-MailMessage Cmdlet kullanımdan kaldırıldı. Bu cmdlet, SMTP sunucularına güvenli bağlantıları garanti etmez. PowerShell'de hemen değiştirilebilecek bir değişiklik olmasa da, kullanmamanızı Send-MailMessageöneririz. Daha fazla bilgi için bkz. Platform Uyumluluğu notu DE0005.

Örnekler

Örnek 1: Bir kişiden diğerine e-posta gönderme

Bu örnek, bir kişiden diğerine e-posta iletisi gönderir.

From, To ve Subject parametreleri tarafından Send-MailMessagegereklidir. Bu örnekte SMTP sunucusu için varsayılan $PSEmailServer değişken kullanıldığından SmtpServer parametresi gerekli değildir.

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

Cmdlet, Send-MailMessage iletinin gönderenini belirtmek için From parametresini kullanır. Hedef parametresi iletinin alıcısını belirtir. İsteğe bağlı Body parametresi dahil edilmediğinden Subject parametresi ileti olarak Test postası metin dizesini kullanır.

Örnek 2: Ek gönderme

Bu örnek, eki olan bir e-posta iletisi gönderir.

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'

Cmdlet, Send-MailMessage iletinin gönderenini belirtmek için From parametresini kullanır. To parametresi iletinin alıcılarını belirtir. Subject parametresi iletinin içeriğini açıklar. Body parametresi iletinin içeriğidir.

Attachments parametresi, e-posta iletisine eklenmiş olan geçerli dizindeki dosyayı belirtir. Priority parametresi iletiyi Yüksek öncelikli olarak ayarlar. -DeliveryNotificationOption parametresi OnSuccess ve OnFailure olarak iki değer belirtir. Gönderen, ileti tesliminin başarılı veya başarısız olduğunu onaylamak için e-posta bildirimleri alır. SmtpServer parametresi SMTP sunucusunu smtp.fabrikam.com olarak ayarlar.

Örnek 3: Posta listesine e-posta gönderme

Bu örnek, posta listesine bir e-posta iletisi gönderir.

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

Cmdlet, Send-MailMessage iletinin gönderenini belirtmek için From parametresini kullanır. To parametresi iletinin alıcılarını belirtir. Bilgi parametresi, iletinin bir kopyasını belirtilen alıcıya gönderir. Gizli parametresi iletinin bir gizli kopyasını gönderir. Gizli kopya, diğer alıcılardan gizlenen bir e-posta adresidir. İsteğe bağlı Body parametresi dahil edilmediğinden Subject parametresi iletidir.

Credential parametresi, iletiyi göndermek için bir etki alanı yöneticisinin kimlik bilgilerinin kullanıldığını belirtir. UseSsl parametresi, Güvenli Yuva Katmanı'nın (SSL) güvenli bir bağlantı oluşturduğunu belirtir.

Parametreler

-Attachments

E-posta iletisine eklenecek dosyaların yolunu ve dosya adlarını belirtir. Bu parametreyi kullanabilir veya yolları ve dosya adlarını öğesine aktarabilirsiniz Send-MailMessage.

Type:String[]
Aliases:PsPath
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Bcc

Postanın bir kopyasını alan ancak iletinin alıcıları olarak listelenmeyen e-posta adreslerini belirtir. Adları (isteğe bağlı) ve gibi Name <someone@fabrikam.com>e-posta adresini girin.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Body

E-posta iletisinin içeriğini belirtir.

Type:String
Position:2
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-BodyAsHtml

Body parametresinin değerinin HTML içerdiğini belirtir.

Type:SwitchParameter
Aliases:BAH
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Cc

E-posta iletisinin karbon kopyasının (CC) gönderileceği e-posta adreslerini belirtir. Adları (isteğe bağlı) ve gibi Name <someone@fabrikam.com>e-posta adresini girin.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Credential

Bu eylemi gerçekleştirme izni olan bir kullanıcı hesabı belirtir. Varsayılan, mevcut kullanıcıdır.

User01 veya Domain01\User01 gibi bir kullanıcı adı yazın. Alternatif olarak, cmdlet'inden Get-Credential bir tane gibi bir PSCredential nesnesi de girin.

Kimlik bilgileri bir PSCredential nesnesinde depolanır ve parola SecureString olarak depolanır.

Not

SecureString veri koruması hakkında daha fazla bilgi için bkz. SecureString ne kadar güvenli?.

Type:PSCredential
Position:Named
Default value:Current user
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-DeliveryNotificationOption

E-posta iletisi için teslim bildirimi seçeneklerini belirtir. Birden çok değer belirtebilirsiniz. Hiçbiri varsayılan değerdir. Bu parametrenin diğer adı DNO'dur.

Teslim bildirimleri From parametresindeki adrese gönderilir.

Bu parametre için kabul edilebilir değerler şunlardır:

  • None: Bildirim yok.
  • OnSuccess: Teslimin başarılı olup olmadığını bildirin.
  • OnFailure: Teslimatın başarısız olup olmadığını bildirin.
  • Delay: Teslimatın gecikip geciktirilmediğini bildirin.
  • Never: Hiçbir zaman bildirimde bulunmayın.
Type:DeliveryNotificationOptions
Aliases:DNO
Accepted values:None, OnSuccess, OnFailure, Delay, Never
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Encoding

Hedef dosya için kodlama türünü belirtir. utf8NoBOM varsayılan değerdir.

Bu parametre için kabul edilebilir değerler şunlardır:

  • ascii: ASCII (7 bit) karakter kümesi için kodlamayı kullanır.
  • bigendianunicode: Büyük endian bayt sırasını kullanarak UTF-16 biçiminde kodlar.
  • oem: MS-DOS ve konsol programları için varsayılan kodlamayı kullanır.
  • unicode: Little-endian bayt sırasını kullanarak UTF-16 biçiminde kodlar.
  • utf7: UTF-7 biçiminde kodlar.
  • utf8: UTF-8 biçiminde kodlar.
  • utf8BOM: Bayt Sipariş İşareti (BOM) ile UTF-8 biçiminde kodlar
  • utf8NoBOM: Bayt Sırası İşareti (BOM) olmadan UTF-8 biçiminde kodlar
  • utf32: UTF-32 biçiminde kodlar.

PowerShell 6.2'den başlayarak Kodlama parametresi, kayıtlı kod sayfalarının (gibi -Encoding 1251) sayısal kimliklerine veya kayıtlı kod sayfalarının dize adlarına (örneğin -Encoding "windows-1251") izin verir. Daha fazla bilgi için Encoding.CodePage için .NET belgelerine bakın.

Type:Encoding
Aliases:BE
Accepted values:ASCII, BigEndianUnicode, OEM, Unicode, UTF7, UTF8, UTF8BOM, UTF8NoBOM, UTF32
Position:Named
Default value:UTF8NoBOM
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-From

From parametresi gereklidir. Bu parametre gönderenin e-posta adresini belirtir. Bir ad (isteğe bağlı) ve gibi Name <someone@fabrikam.com>bir e-posta adresi girin.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Port

SMTP sunucusunda alternatif bir bağlantı noktası belirtir. Varsayılan değer, varsayılan SMTP bağlantı noktası olan 25'tir.

Type:Int32
Position:Named
Default value:25
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Priority

E-posta iletisinin önceliğini belirtir. Normal varsayılan değerdir. Bu parametre için kabul edilebilir değerler Normal, Yüksek ve Düşük'lerdir.

Type:MailPriority
Accepted values:Normal, High, Low
Position:Named
Default value:Normal
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ReplyTo

Bu iletiyi yanıtlamak için kullanılacak ek e-posta adreslerini (Kimden adresi dışında) belirtir. Adları (isteğe bağlı) ve gibi Name <someone@fabrikam.com>e-posta adresini girin.

Bu parametre PowerShell 6.2'de kullanıma sunulmuştur.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-SmtpServer

E-posta iletisini gönderen SMTP sunucusunun adını belirtir.

Varsayılan değer, tercih değişkeninin $PSEmailServer değeridir. Tercih değişkeni ayarlanmadıysa ve bu parametre kullanılmıyorsa, Send-MailMessage komut başarısız olur.

Type:String
Aliases:ComputerName
Position:3
Default value:$PSEmailServer
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Subject

Subject parametresi gereklidir. Bu parametre, e-posta iletisinin konusunu belirtir.

Type:String
Aliases:sub
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-To

To parametresi gereklidir. Bu parametre alıcının e-posta adresini belirtir. Birden çok alıcı varsa, adreslerini virgülle (, ) ayırın. Adları (isteğe bağlı) ve gibi Name <someone@fabrikam.com>e-posta adresini girin.

Type:String[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-UseSsl

Güvenli Yuva Katmanı (SSL) protokolü, posta göndermek üzere uzak bilgisayara güvenli bir bağlantı kurmak için kullanılır. Varsayılan olarak SSL kullanılmaz.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

Girişler

String

Eklerin yolunu ve dosya adlarını öğesine aktarabilirsiniz Send-MailMessage.

Çıkışlar

None

Bu cmdlet herhangi bir çıkış oluşturmaz.