如何用Azure PowerShell检查收件箱特定邮件？连接Outlook服务器遇阻

我明白你之前用Windows PowerShell结合Microsoft.Office.Interop.Outlook成功实现了收件箱特定邮件的检查，但在Azure PowerShell环境里遇到了连接Outlook服务器的问题——这其实是因为Outlook Interop依赖本地安装的Outlook客户端，而Azure PowerShell运行在云端会话/容器中，没有本地Outlook实例，所以这种方式在云端环境下完全不可行。

别担心，我们可以改用Microsoft Graph PowerShell模块来实现同样的需求，这是微软官方推荐的、云端友好的访问Exchange Online（包括Outlook邮箱）的方式。下面是具体的实现步骤：

1. 安装Microsoft Graph PowerShell模块 #

首先在Azure PowerShell会话中安装官方模块：

# 安装模块（首次安装需信任PSGallery）
Install-Module -Name Microsoft.Graph -Force -AllowClobber

如果是首次使用PowerShell Gallery，可能需要先执行Set-PSRepository -Name PSGallery -InstallationPolicy Trusted来信任仓库。

2. 授权访问邮箱权限 #

我们需要获取Mail.Read权限来读取收件箱内容，执行以下命令并按照提示完成登录授权：

# 连接Microsoft Graph并请求邮件读取权限
Connect-MgGraph -Scopes "Mail.Read"

授权完成后，你的Azure PowerShell会话就具备了访问目标邮箱的权限。

3. 编写脚本检查特定邮件 #

接下来可以编写脚本筛选收件箱中的特定邮件，比如按主题关键词、发件人、接收时间等条件过滤。以下是示例代码：

# 定义筛选条件（可根据需求调整）
$filterCondition = "contains(subject,'你的特定主题关键词') AND from/emailAddress/address eq 'sender@example.com' AND receivedDateTime ge $((Get-Date).AddHours(-24).ToUniversalTime().ToString('yyyy-MM-ddTHH:mm:ssZ'))"

# 获取收件箱中符合条件的邮件
$targetEmails = Get-MgUserMessage -UserId "your-email@example.com" -Filter $filterCondition -Select subject,from,receivedDateTime

# 输出结果
if ($targetEmails) {
    Write-Host "找到符合条件的邮件："
    $targetEmails | Format-List Subject, From, ReceivedDateTime
} else {
    Write-Host "未找到符合条件的邮件"
}

关键说明： #

• UserId参数填写你要检查的邮箱地址（可以是当前授权用户的邮箱，也可以是你有权访问的其他邮箱）
• $filterCondition支持多种OData筛选规则，比如：
  • 按主题精确匹配：subject eq 'Exact Subject'
  • 按发件人域名筛选：from/emailAddress/address ends with '@yourdomain.com'
  • 按未读状态筛选：isRead eq false

为什么这个方案可行？ #

和依赖本地Outlook的Interop方式不同，Microsoft Graph API直接通过云端接口访问Exchange Online邮箱，完全适配Azure PowerShell的云端运行环境，不需要本地客户端支持，同时权限控制更精细、安全性更高。

内容的提问来源于stack exchange，提问作者Akshara R