Skip to main content

New-MSGraphMail

SYNOPSIS

Creates, and optionally sends, a new message using the Microsoft Graph API.

SYNTAX

MIME

New-MSGraphMail -Mailbox <String> -MIMEMessage <String> [-Folder <String>] [-Pipeline] [-Send] [-SaveandSend]
[<CommonParameters>]

Standard

New-MSGraphMail -From <String[]> -To <String[]> [-CC <String[]>] [-BCC <String[]>] [-Subject <String>]
-BodyContent <String> [-FooterContent <String>] -BodyFormat <String> [-Folder <String>]
[-Attachments <String[]>] [-InlineAttachments <String[]>] [-Draft] [-RequestDeliveryReceipt]
[-RequestReadReceipt] [-Pipeline] [-Send] [-SaveandSend] [<CommonParameters>]

DESCRIPTION

Uses the Microsoft Graph API to create a new message, optionally sending it, and optionally saving it to a folder. If the message is not sent, it will be saved as a draft. If the message is sent, it will be saved to the Sent Items folder. The message can be created using a standard set of parameters, or by providing a MIME message.

EXAMPLES

PARAMETERS

-Mailbox

The mailbox to use to send the message.

Type: String
Parameter Sets: MIME
Aliases:

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

-From

The sender of the message.

Type: String[]
Parameter Sets: Standard
Aliases:

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

-To

The recipient(s) of the message.

Type: String[]
Parameter Sets: Standard
Aliases:

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

-CC

The CC recipient(s) of the message.

Type: String[]
Parameter Sets: Standard
Aliases:

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

-BCC

The BCC recipient(s) of the message.

Type: String[]
Parameter Sets: Standard
Aliases:

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

-Subject

The subject of the message.

Type: String
Parameter Sets: Standard
Aliases:

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

-BodyContent

The body of the message.

Type: String
Parameter Sets: Standard
Aliases:

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

-FooterContent

The footer of the message.

Type: String
Parameter Sets: Standard
Aliases:

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

-BodyFormat

The format of the message body.

Type: String
Parameter Sets: Standard
Aliases:

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

-MIMEMessage

The MIME message to send.

Type: String
Parameter Sets: MIME
Aliases:

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

-Folder

The folder to save the message to.

Type: String
Parameter Sets: (All)
Aliases:

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

-Attachments

The attachments to add to the message.

Type: String[]
Parameter Sets: Standard
Aliases:

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

-InlineAttachments

The inline attachments to add to the message.

Type: String[]
Parameter Sets: Standard
Aliases:

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

-Draft

Mark the message as a draft.

Type: SwitchParameter
Parameter Sets: Standard
Aliases:

Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False

-RequestDeliveryReceipt

Request a delivery receipt.

Type: SwitchParameter
Parameter Sets: Standard
Aliases:

Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False

-RequestReadReceipt

Request a read receipt.

Type: SwitchParameter
Parameter Sets: Standard
Aliases:

Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False

-Pipeline

Process the message through the pipeline.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False

-Send

Send the message.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False

-SaveandSend

Save the message to the Sent Items folder.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

INPUTS

OUTPUTS

A powershell object containing the response.

NOTES