Send-MgUserMessage

Send an existing draft message. The draft message can be a new message draft, reply draft, reply-all draft, or a forward draft. This method saves the message in the Sent Items folder. Alternatively, send a new message in a single operation.

Syntax

Send-MgUserMessage
    -MessageId <String>
    -UserId <String>
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]
Send-MgUserMessage
    -InputObject <IUsersActionsIdentity>
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

Send an existing draft message. The draft message can be a new message draft, reply draft, reply-all draft, or a forward draft. This method saves the message in the Sent Items folder. Alternatively, send a new message in a single operation.

Examples

Example 1: Using the Send-MgUserMessage Cmdlet

Import-Module Microsoft.Graph.Users.Actions
# A UPN can also be used as -UserId.
Send-MgUserMessage -UserId $userId -MessageId $messageId

This example shows how to use the Send-MgUserMessage Cmdlet. To learn about permissions for this resource, see the permissions reference.

Parameters

-Confirm

Prompts you for confirmation before running the cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

Identity Parameter To construct, please use Get-Help -Online and see NOTES section for INPUTOBJECT properties and create a hash table.

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

-MessageId

key: id of message

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

-PassThru

Returns true when the command succeeds

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

-UserId

key: id of user

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

-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet is not run.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

Inputs

Microsoft.Graph.PowerShell.Models.IUsersActionsIdentity

Outputs

System.Boolean

Notes

ALIASES

COMPLEX PARAMETER PROPERTIES

To create the parameters described below, construct a hash table containing the appropriate properties. For information on hash tables, run Get-Help about_Hash_Tables.

INPUTOBJECT <IUsersActionsIdentity>: Identity Parameter

  • [AccessReviewInstanceId <String>]: key: id of accessReviewInstance
  • [AccessReviewStageId <String>]: key: id of accessReviewStage
  • [AppLogCollectionRequestId <String>]: key: id of appLogCollectionRequest
  • [AuthenticationMethodId <String>]: key: id of authenticationMethod
  • [BaseTaskId <String>]: key: id of baseTask
  • [BaseTaskListId <String>]: key: id of baseTaskList
  • [CalendarId <String>]: key: id of calendar
  • [ChatId <String>]: key: id of chat
  • [ChatMessageId <String>]: key: id of chatMessage
  • [ChatMessageId1 <String>]: key: id of chatMessage
  • [CloudPcId <String>]: key: id of cloudPC
  • [ContentTypeId <String>]: key: id of contentType
  • [DeviceEnrollmentConfigurationId <String>]: key: id of deviceEnrollmentConfiguration
  • [DeviceId <String>]: key: id of device
  • [DeviceLogCollectionResponseId <String>]: key: id of deviceLogCollectionResponse
  • [DocumentSetVersionId <String>]: key: id of documentSetVersion
  • [DriveId <String>]: key: id of drive
  • [DriveItemId <String>]: key: id of driveItem
  • [DriveItemVersionId <String>]: key: id of driveItemVersion
  • [EventId <String>]: key: id of event
  • [EventId1 <String>]: key: id of event
  • [ListItemId <String>]: key: id of listItem
  • [ListItemVersionId <String>]: key: id of listItemVersion
  • [MailFolderId <String>]: key: id of mailFolder
  • [MailFolderId1 <String>]: key: id of mailFolder
  • [ManagedDeviceId <String>]: key: id of managedDevice
  • [MessageId <String>]: key: id of message
  • [MicrosoftAuthenticatorAuthenticationMethodId <String>]: key: id of microsoftAuthenticatorAuthenticationMethod
  • [MobileAppTroubleshootingEventId <String>]: key: id of mobileAppTroubleshootingEvent
  • [NotebookId <String>]: key: id of notebook
  • [OnenotePageId <String>]: key: id of onenotePage
  • [OnenoteSectionId <String>]: key: id of onenoteSection
  • [OutlookTaskFolderId <String>]: key: id of outlookTaskFolder
  • [OutlookTaskGroupId <String>]: key: id of outlookTaskGroup
  • [OutlookTaskId <String>]: key: id of outlookTask
  • [PasswordlessMicrosoftAuthenticatorAuthenticationMethodId <String>]: key: id of passwordlessMicrosoftAuthenticatorAuthenticationMethod
  • [PermissionId <String>]: key: id of permission
  • [PhoneAuthenticationMethodId <String>]: key: id of phoneAuthenticationMethod
  • [ResourceSpecificPermissionGrantId <String>]: key: id of resourceSpecificPermissionGrant
  • [SensitivityLabelId <String>]: key: id of sensitivityLabel
  • [SubscriptionId <String>]: key: id of subscription
  • [TeamsAppInstallationId <String>]: key: id of teamsAppInstallation
  • [TodoTaskId <String>]: key: id of todoTask
  • [TodoTaskListId <String>]: key: id of todoTaskList
  • [UserId <String>]: key: id of user
  • [WindowsHelloForBusinessAuthenticationMethodId <String>]: key: id of windowsHelloForBusinessAuthenticationMethod