Partager via

Send-AzEmailServicedataEmail

  • Référence
Module:
Az.Communication

Met en file d’attente un message électronique à envoyer à un ou plusieurs destinataires

Syntaxe

Send-AzEmailServicedataEmail
    -Endpoint <String>
    [-ClientRequestId <String>]
    [-OperationId <String>]
    -Message <IEmailMessage>
    [-DefaultProfile <PSObject>]
    [-AsJob]
    [-NoWait]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]
Send-AzEmailServicedataEmail
    -Endpoint <String>
    [-ClientRequestId <String>]
    [-OperationId <String>]
    -ContentSubject <String>
    -RecipientTo <IEmailAddress[]>
    -SenderAddress <String>
    [-Attachment <IEmailAttachment[]>]
    [-ContentHtml <String>]
    [-ContentPlainText <String>]
    [-Header <Hashtable>]
    [-RecipientBcc <IEmailAddress[]>]
    [-RecipientCc <IEmailAddress[]>]
    [-ReplyTo <IEmailAddress[]>]
    [-UserEngagementTrackingDisabled]
    [-DefaultProfile <PSObject>]
    [-AsJob]
    [-NoWait]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]
Send-AzEmailServicedataEmail
    -Endpoint <String>
    [-ClientRequestId <String>]
    [-OperationId <String>]
    -JsonFilePath <String>
    [-DefaultProfile <PSObject>]
    [-AsJob]
    [-NoWait]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]
Send-AzEmailServicedataEmail
    -Endpoint <String>
    [-ClientRequestId <String>]
    [-OperationId <String>]
    -JsonString <String>
    [-DefaultProfile <PSObject>]
    [-AsJob]
    [-NoWait]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

Met en file d’attente un message électronique à envoyer à un ou plusieurs destinataires

Exemples

Exemple 1 : Met en file d’attente un message électronique à envoyer à un ou plusieurs destinataires

$emailRecipientTo = @(
   @{
        Address = "abc@contoso.com"
        DisplayName = "abc"
    }
)

$message = @{
	ContentSubject = "Test Email"
	RecipientTo = @($emailRecipientTo)  # Array of email address objects
	SenderAddress = 'info@contoso.com'	
	ContentPlainText = "This is the first email from ACS - HTML"	
}

Send-AzEmailServicedataEmail -Message $Message -endpoint "https://contoso.unitedstates.communication.azure.com"

AdditionalInfo    :
Code              :
Detail            :
Id                : 1111c0de-899f-5cce-acb5-3ec493af3800
Message           :
ResourceGroupName :
RetryAfter        :
Status            : Succeeded
Target            :

Met en file d’attente un message électronique à envoyer à un ou plusieurs destinataires, ci-dessus est l’exemple avec uniquement les champs obligatoires.

Exemple 2 : Met en file d’attente un message électronique à envoyer à un ou plusieurs destinataires

$emailRecipientTo = @(
   @{
        Address = "abc@contoso.com"
        DisplayName = "abc"
    },
   @{
        Address = "def@contoso.com"
        DisplayName = "def"
    }
)

$fileBytes1 = [System.IO.File]::ReadAllBytes("<file path>")

$fileBytes2 = [System.IO.File]::ReadAllBytes("<image file path>")

$emailAttachment = @(
	@{
		ContentInBase64 = $fileBytes1
		ContentType = "<text/plain>"
		Name = "<test.txt>"
	},
	@{
		ContentInBase64 = $fileBytes2
		ContentType = "image/png"
		Name = "<inline-attachment.png>"
		contentId = "<inline-attachment>"
	}
)

$headers = @{
    "Key1" = "Value1"
    "Key2" = "Value2"
	"Importance" = "high"
}

$emailRecipientBcc = @(
   @{
        Address = "abc@contoso.com"
        DisplayName = "abc"
    }
)

$emailRecipientCc = @(
   @{
        Address = "abc@contoso.com"
        DisplayName = "abc"
    }
)

$emailRecipientReplyTo = @(
   @{
        Address = "abc@contoso.com"
        DisplayName = "abc"
    }
)

$message = @{
	ContentSubject = "Test Email"
	RecipientTo = @($emailRecipientTo)  # Array of email address objects
	SenderAddress = 'info@contoso.com'
	Attachment = @($emailAttachment) # Array of attachments
	ContentHtml = "<html><head><title>Enter title</title></head><body><img src='cid:inline-attachment' alt='Company Logo'/><h1>This is the first email from ACS - HTML</h1></body></html>"
	ContentPlainText = "This is the first email from ACS - HTML"
	Header = $headers  # Importance = high/medium/low or X-Priority = 2/3/4  
	RecipientBcc = @($emailRecipientBcc) # Array of email address objects
	RecipientCc = @($emailRecipientCc) # Array of email address objects
	ReplyTo = @($emailRecipientReplyTo) # Array of email address objects
	UserEngagementTrackingDisabled = $true
}

Send-AzEmailServicedataEmail -Message $Message -endpoint "https://contoso.unitedstates.communication.azure.com"

AdditionalInfo    :
Code              :
Detail            :
Id                : 1111c0de-899f-5cce-acb5-3ec493af3801
Message           :
ResourceGroupName :
RetryAfter        :
Status            : Succeeded
Target            :

Met en file d’attente un message électronique à envoyer à un ou plusieurs destinataires, ci-dessus est l’exemple avec tous les champs.

Paramètres

-AsJob

Exécuter la commande en tant que travail

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Attachment

Liste des pièces jointes. Notez que nous limitons la taille totale d’une demande de courrier électronique (qui inclut des pièces jointes régulières et inline) à 10 Mo.

Type:IEmailAttachment[]
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ClientRequestId

ID de suivi envoyé avec la demande pour faciliter le débogage.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Confirm

Vous invite à confirmer avant d’exécuter l’applet de commande.

Type:SwitchParameter
Alias:cf
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ContentHtml

Version html du message électronique.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ContentPlainText

Version en texte brut du message électronique.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ContentSubject

Objet du message électronique

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-DefaultProfile

Le paramètre DefaultProfile n’est pas fonctionnel. Utilisez le paramètre SubscriptionId lorsqu’il est disponible si vous exécutez l’applet de commande sur un autre abonnement.

Type:PSObject
Alias:AzureRMContext, AzureCredential
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Endpoint

Ressource de communication, par exemple https://my-resource.communication.azure.com

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Header

En-têtes de courrier personnalisés à passer.

Type:Hashtable
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-JsonFilePath

Chemin d’accès du fichier Json fourni à l’opération d’envoi

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-JsonString

Chaîne Json fournie à l’opération d’envoi

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Message

Charge utile de message pour l’envoi d’un e-mail

Type:IEmailMessage
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-NoWait

Exécuter la commande de manière asynchrone

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-OperationId

Il s’agit de l’ID fourni par le client pour identifier l’opération de longue durée. Si un ID n’est pas fourni par le client, le service en génère un.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-RecipientBcc

Destinataires du cci de messagerie

Type:IEmailAddress[]
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-RecipientCc

Destinataires CC d’e-mail

Type:IEmailAddress[]
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-RecipientTo

Adresse e-mail aux destinataires

Type:IEmailAddress[]
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ReplyTo

Adresses e-mail auxquelles les réponses des destinataires seront envoyées.

Type:IEmailAddress[]
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-SenderAddress

Adresse e-mail de l’expéditeur à partir d’un domaine vérifié.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-UserEngagementTrackingDisabled

Indique si le suivi de l’engagement utilisateur doit être désactivé pour cette demande si le paramètre de suivi de l’engagement utilisateur au niveau de la ressource a déjà été activé dans le plan de contrôle.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-WhatIf

Affiche ce qui se passerait si l’applet de commande s’exécute. L’applet de commande n’est pas exécutée.

Type:SwitchParameter
Alias:wi
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

Entrées

IEmailMessage

Sorties

IEmailSendResult