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[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[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[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