Share via

New-MgBetaUserMessageAttachment

  • Reference
Module:
Microsoft.Graph.Beta.Mail

Create new navigation property to attachments for users

Note

To view the v1.0 release of this cmdlet, view New-MgUserMessageAttachment

Syntax

New-MgBetaUserMessageAttachment
   -MessageId <String>
   -UserId <String>
   [-ResponseHeadersVariable <String>]
   [-AdditionalProperties <Hashtable>]
   [-ContentType <String>]
   [-Id <String>]
   [-IsInline]
   [-LastModifiedDateTime <DateTime>]
   [-Name <String>]
   [-Size <Int32>]
   [-Headers <IDictionary>]
   [-ProgressAction <ActionPreference>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-MgBetaUserMessageAttachment
   -MessageId <String>
   -UserId <String>
   -BodyParameter <IMicrosoftGraphAttachment>
   [-ResponseHeadersVariable <String>]
   [-Headers <IDictionary>]
   [-ProgressAction <ActionPreference>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-MgBetaUserMessageAttachment
   -InputObject <IMailIdentity>
   [-ResponseHeadersVariable <String>]
   [-AdditionalProperties <Hashtable>]
   [-ContentType <String>]
   [-Id <String>]
   [-IsInline]
   [-LastModifiedDateTime <DateTime>]
   [-Name <String>]
   [-Size <Int32>]
   [-Headers <IDictionary>]
   [-ProgressAction <ActionPreference>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-MgBetaUserMessageAttachment
   -InputObject <IMailIdentity>
   -BodyParameter <IMicrosoftGraphAttachment>
   [-ResponseHeadersVariable <String>]
   [-Headers <IDictionary>]
   [-ProgressAction <ActionPreference>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Create new navigation property to attachments for users

Examples

Example 1: Code snippet

Import-Module Microsoft.Graph.Beta.Mail

$params = @{
	"@odata.type" = "#Microsoft.OutlookServices.FileAttachment"
	name = "name-value"
	contentType = "contentType-value"
	isInline = $false
	contentLocation = "contentLocation-value"
	contentBytes = "contentBytes-value"
}

# A UPN can also be used as -UserId.
New-MgBetaUserMessageAttachment -UserId $userId -MessageId $messageId -BodyParameter $params

This example shows how to use the New-MgBetaUserMessageAttachment Cmdlet.

To learn about permissions for this resource, see the permissions reference.

Parameters

-AdditionalProperties

Additional Parameters

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

-BodyParameter

attachment To construct, see NOTES section for BODYPARAMETER properties and create a hash table.

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

-Confirm

Prompts you for confirmation before running the cmdlet.

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

-ContentType

The MIME type.

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

-Headers

Optional headers that will be added to the request.

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

-Id

The unique identifier for an entity. Read-only.

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

-InputObject

Identity Parameter To construct, see NOTES section for INPUTOBJECT properties and create a hash table.

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

-IsInline

true if the attachment is an inline attachment; otherwise, false.

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

-LastModifiedDateTime

The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z

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

-MessageId

The unique identifier of message

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

-Name

The display name of the attachment. This does not need to be the actual file name.

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

-ProgressAction

{{ Fill ProgressAction Description }}

Type:ActionPreference
Aliases:proga
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ResponseHeadersVariable

Optional Response Headers Variable.

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

-Size

The length of the attachment in bytes.

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

-UserId

The unique identifier of user

Type:String
Position:Named
Default value:None
Required:True
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
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Inputs

Microsoft.Graph.Beta.PowerShell.Models.IMailIdentity

Microsoft.Graph.Beta.PowerShell.Models.IMicrosoftGraphAttachment

System.Collections.IDictionary

Outputs

Microsoft.Graph.Beta.PowerShell.Models.IMicrosoftGraphAttachment

Notes

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.

BODYPARAMETER <IMicrosoftGraphAttachment>: attachment

  • [(Any) <Object>]: This indicates any property can be added to this object.
  • [Id <String>]: The unique identifier for an entity. Read-only.
  • [ContentType <String>]: The MIME type.
  • [IsInline <Boolean?>]: true if the attachment is an inline attachment; otherwise, false.
  • [LastModifiedDateTime <DateTime?>]: The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z
  • [Name <String>]: The display name of the attachment. This does not need to be the actual file name.
  • [Size <Int32?>]: The length of the attachment in bytes.

INPUTOBJECT <IMailIdentity>: Identity Parameter

  • [AttachmentId <String>]: The unique identifier of attachment
  • [ExtensionId <String>]: The unique identifier of extension
  • [InferenceClassificationOverrideId <String>]: The unique identifier of inferenceClassificationOverride
  • [MailFolderId <String>]: The unique identifier of mailFolder
  • [MailFolderId1 <String>]: The unique identifier of mailFolder
  • [MentionId <String>]: The unique identifier of mention
  • [MessageId <String>]: The unique identifier of message
  • [MessageRuleId <String>]: The unique identifier of messageRule
  • [UserConfigurationId <String>]: The unique identifier of userConfiguration
  • [UserId <String>]: The unique identifier of user