E-mails/Attachments

This section comprises a variety of functions designed to gather e-mails and their attachments.

Note

Important note The following functions require the ‘Mail.Readwrite’ scope which is an application-level permission, requiring an application-based connection through the ‘Connect-MgGraph’ command for its use.

Get a specific email.

Get a specific email based on userId and Internet Message Id and saves the output to a eml or txt file.

Usage

Retrieves an email from fortunahodan@bonacu.onmicrosoft.com with the internet message identifier <d6f15b97-e3e3-4871-adb2-e8d999d51f34@az.westeurope.microsoft.com> to a eml file.

Get-Email -userIds fortunahodan@bonacu.onmicrosoft.com -internetMessageId "<d6f15b97-e3e3-4871-adb2-e8d999d51f34@az.westeurope.microsoft.com>"

Retrieves an email and the attachment from fortunahodan@bonacu.onmicrosoft.com with the internet message identifier <d6f15b97-e3e3-4871-adb2-e8d999d51f34@az.westeurope.microsoft.com> to a eml file.

Get-Email -userIds fortunahodan@bonacu.onmicrosoft.com -internetMessageId "<d6f15b97-e3e3-4871-adb2-e8d999d51f34@az.westeurope.microsoft.com>" -attachment True

Retrieves an email and saves it to C:\Windows\Temp folder.

Get-Email -userIds fortunahodan@bonacu.onmicrosoft.com -internetMessageId "<d6f15b97-e3e3-4871-adb2-e8d999d51f34@az.westeurope.microsoft.com>" -OutputDir C:\Windows\Temp

Parameters

-UserIds (Mandatory)

  • The unique identifier of the user.

-InternetMessageId (Mandatory)

  • The InternetMessageId parameter represents the Internet message identifier of an item.

-Output (optional)

  • Output is the parameter specifying the eml or txt output type.

  • Default: eml

-OutputDir (optional)

  • OutputDir is the parameter specifying the output directory.

  • Default: EmailExport

-inputFile (optional)

  • The inputFile parameter specifies the .txt file containing multiple Internet Message Identifiers. You can include multiple Internet Message Identifiers in the file. Ensure each ID is placed on a new line.

-Attachment (optional)

  • The attachment parameter specifies whether the attachment should be saved or not.

  • Default: False

-LogLevel (optional)

  • Specifies the level of logging. None: No logging. Minimal: Logs critical errors only. Standard: Normal operational logging.

  • Default: Standard

Output

The output will be saved to the ‘EmailExport’ directory within the ‘Output’ directory.

Permissions

  • Before utilizing this function, it is essential to ensure that the appropriate permissions have been granted. This function relies on the Microsoft Graph API and requires an application to authenticate with specific scopes that grant the necessary access levels.

  • Make sure to connect using the following permission: ‘Mail.Readwrite’.

  • For instance, if you choose to use User.Read.All, your command would look like this: Connect-MgGraph -Scopes ‘Mail.Readwrite’

Get a specific attachment.

Get a specific attachment based on userId and Internet Message Id and saves the output.

Usage

Retrieves the attachment from fortunahodan@bonacu.onmicrosoft.com with the internet message identifier <d6f15b97-e3e3-4871-adb2-e8d999d51f34@az.westeurope.microsoft.com>.

Get-Attachment -userIds fortunahodan@bonacu.onmicrosoft.com -internetMessageId "<d6f15b97-e3e3-4871-adb2-e8d999d51f34@az.westeurope.microsoft.com>"

Retrieves an attachment and saves it to C:WindowsTemp folder.

Get-Attachment -userIds fortunahodan@bonacu.onmicrosoft.com -internetMessageId "<d6f15b97-e3e3-4871-adb2-e8d999d51f34@az.westeurope.microsoft.com>" -OutputDir C:\Windows\Temp

Parameters

-UserIds (Mandatory)

  • The unique identifier of the user.

-InternetMessageId (Mandatory)

  • The InternetMessageId parameter represents the Internet message identifier of an item.

-OutputDir (optional)

  • OutputDir is the parameter specifying the output directory.

  • Default: EmailExport

-LogLevel (optional)

  • Specifies the level of logging. None: No logging. Minimal: Logs critical errors only. Standard: Normal operational logging.

  • Default: Standard

Output

The output will be saved to the ‘EmailExport’ directory within the ‘Output’ directory.

Permissions

  • Before utilizing this function, it is essential to ensure that the appropriate permissions have been granted. This function relies on the Microsoft Graph API and requires an application to authenticate with specific scopes that grant the necessary access levels.

  • Make sure to connect using the following permission: ‘Mail.Readwrite’.

  • For instance, if you choose to use User.Read.All, your command would look like this: Connect-MgGraph -Scopes ‘Mail.Readwrite’

Show e-mail.

Show a specific email in the PowerShell Window.

Usage

Show a specific email in the PowerShell Window.

Show-Email -userIds {userId} -internetMessageId {InternetMessageId}

Parameters

-UserIds (Mandatory)

  • The unique identifier of the user.

-InternetMessageId (Mandatory)

  • The InternetMessageId parameter represents the Internet message identifier of an item.