< Back
Add-MgaMailMessageForward
Post
NAME Add-MgaMailMessageForward
SYNOPSIS
Forward message(s) in Exchange Online using the graph api.
SYNTAX
Add-MgaMailMessageForward [-Message] <MessageParameter[]> [-User <String>] [-Token <AzureAccessToken>] [-WhatIf]
[-Confirm] [<CommonParameters>]
Add-MgaMailMessageForward [-Message] <MessageParameter[]> -ToRecipients <String[]> -Comment <String> [-User
<String>] [-Token <AzureAccessToken>] [-PassThru] [-WhatIf] [-Confirm] [<CommonParameters>]
DESCRIPTION
Creates forward message(s) and save it as draft message(s).
Alternatively, the command can directly forward a message by specifing recipient(s) and text
The message is then saved in the Sent Items folder.
PARAMETERS
-Message <MessageParameter[]>
Carrier object for Pipeline input.
This can be the id of the message or a message object passed in.
Required? true
Position? 1
Default value
Accept pipeline input? true (ByValue, ByPropertyName)
Accept wildcard characters? false
-ToRecipients <String[]>
The To recipients for the message.
Required? true
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-Comment <String>
The body of the message.
Required? true
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-User <String>
The user-account to access. Defaults to the main user connected as.
Can be any primary email name of any user the connected token has access to.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-Token <AzureAccessToken>
The token representing an established connection to the Microsoft Graph Api.
Can be created by using New-MgaAccessToken.
Can be omitted if a connection has been registered using the -Register parameter on New-MgaAccessToken.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-PassThru [<SwitchParameter>]
Outputs the token to the console
Required? false
Position? named
Default value False
Accept pipeline input? false
Accept wildcard characters? false
-WhatIf [<SwitchParameter>]
If this switch is enabled, no actions are performed but informational messages will be displayed that explain
what would happen if the command were to run.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-Confirm [<SwitchParameter>]
If this switch is enabled, you will be prompted for confirmation before executing any operations that change
state.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (https:/go.microsoft.com/fwlink/?LinkID=113216).
INPUTS
OUTPUTS
MSGraph.Exchange.Mail.Message
NOTES
For addiontional information about Microsoft Graph API go to:
https://docs.microsoft.com/en-us/graph/ ... h-rest-1.0
https://docs.microsoft.com/en-us/graph/ ... h-rest-1.0
-------------------------- EXAMPLE 1 --------------------------
PS C:\\>$mail | Add-MgaMailMessageForward
Create forward message(s) and save it in the drafts folder for messages from variable $mail.
also possible:
PS C:\\> Add-MgaMailMessageForward -Message $mail
The variable $mail can be represent:
PS C:\\> $mail = Get-MgaMailMessage -Subject "Important mail"
-------------------------- EXAMPLE 2 --------------------------
PS C:\\>$mail | Add-MgaMailMessageForward -ToRecipients 'someone@something.org' -Comment 'For your information.'
This one directly forwards message(s) from variable $mail. The message(s) is saved in the sendItems folder
The variable $mail can be represent:
PS C:\\> $mail = Get-MgaMailMessage -Subject "Important mail"
RELATED LINKS
SYNOPSIS
Forward message(s) in Exchange Online using the graph api.
SYNTAX
Add-MgaMailMessageForward [-Message] <MessageParameter[]> [-User <String>] [-Token <AzureAccessToken>] [-WhatIf]
[-Confirm] [<CommonParameters>]
Add-MgaMailMessageForward [-Message] <MessageParameter[]> -ToRecipients <String[]> -Comment <String> [-User
<String>] [-Token <AzureAccessToken>] [-PassThru] [-WhatIf] [-Confirm] [<CommonParameters>]
DESCRIPTION
Creates forward message(s) and save it as draft message(s).
Alternatively, the command can directly forward a message by specifing recipient(s) and text
The message is then saved in the Sent Items folder.
PARAMETERS
-Message <MessageParameter[]>
Carrier object for Pipeline input.
This can be the id of the message or a message object passed in.
Required? true
Position? 1
Default value
Accept pipeline input? true (ByValue, ByPropertyName)
Accept wildcard characters? false
-ToRecipients <String[]>
The To recipients for the message.
Required? true
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-Comment <String>
The body of the message.
Required? true
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-User <String>
The user-account to access. Defaults to the main user connected as.
Can be any primary email name of any user the connected token has access to.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-Token <AzureAccessToken>
The token representing an established connection to the Microsoft Graph Api.
Can be created by using New-MgaAccessToken.
Can be omitted if a connection has been registered using the -Register parameter on New-MgaAccessToken.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-PassThru [<SwitchParameter>]
Outputs the token to the console
Required? false
Position? named
Default value False
Accept pipeline input? false
Accept wildcard characters? false
-WhatIf [<SwitchParameter>]
If this switch is enabled, no actions are performed but informational messages will be displayed that explain
what would happen if the command were to run.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-Confirm [<SwitchParameter>]
If this switch is enabled, you will be prompted for confirmation before executing any operations that change
state.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (https:/go.microsoft.com/fwlink/?LinkID=113216).
INPUTS
OUTPUTS
MSGraph.Exchange.Mail.Message
NOTES
For addiontional information about Microsoft Graph API go to:
https://docs.microsoft.com/en-us/graph/ ... h-rest-1.0
https://docs.microsoft.com/en-us/graph/ ... h-rest-1.0
-------------------------- EXAMPLE 1 --------------------------
PS C:\\>$mail | Add-MgaMailMessageForward
Create forward message(s) and save it in the drafts folder for messages from variable $mail.
also possible:
PS C:\\> Add-MgaMailMessageForward -Message $mail
The variable $mail can be represent:
PS C:\\> $mail = Get-MgaMailMessage -Subject "Important mail"
-------------------------- EXAMPLE 2 --------------------------
PS C:\\>$mail | Add-MgaMailMessageForward -ToRecipients 'someone@something.org' -Comment 'For your information.'
This one directly forwards message(s) from variable $mail. The message(s) is saved in the sendItems folder
The variable $mail can be represent:
PS C:\\> $mail = Get-MgaMailMessage -Subject "Important mail"
RELATED LINKS