PowerShell脚本仅下载10个附件即停止问题排查求助

嘿，这个问题我之前帮好几个朋友解决过，大概率是默认限制或者脚本逻辑里的小疏漏在搞鬼！咱们一步步排查：

最常见的原因：获取邮件时的数量限制 #

Exchange Online（或本地Exchange）的PowerShell模块默认会限制返回的邮件数量，如果你没明确指定无限制，某些测试场景下可能只返回前10封邮件，自然只会下载对应数量的附件。

比如你的脚本如果写了：

$emails = Get-EXOMailMessage -Mailbox "你的邮箱@域名.com" -FolderPath Inbox

一定要加上-ResultSize Unlimited来取消数量限制：

# 正确写法：获取收件箱所有邮件，无数量限制
$emails = Get-EXOMailMessage -Mailbox "你的邮箱@域名.com" -FolderPath Inbox -ResultSize Unlimited

第二个可能：循环逻辑里的意外中断 #

检查你的脚本是不是不小心加了限制循环次数的代码，比如：

$count = 0
foreach ($email in $emails) {
    $count++
    if ($count -gt 10) { break } # 这里的break会让循环在第10次后强制停止！
    # 下载附件的代码
}

或者用了Select-Object -First 10来筛选邮件，这也会导致只处理前10封邮件。

第三个可能：脚本中途报错中断 #

如果下载第10个附件时遇到错误（比如文件重名、权限不足、附件损坏），而你的脚本没有错误处理逻辑，就会直接停止运行。

给你一个完善的示例脚本 #

这个脚本会处理所有邮件附件，跳过内嵌签名图片，自动处理重名文件，并且遇到错误时不会中断整体流程：

# 配置参数
$mailbox = "你的邮箱@域名.com"
$downloadPath = "C:\邮件附件"

# 创建下载目录（如果不存在）
if (-not (Test-Path $downloadPath)) {
    New-Item -ItemType Directory -Path $downloadPath | Out-Null
}

# 获取收件箱所有邮件（无数量限制）
$emails = Get-EXOMailMessage -Mailbox $mailbox -FolderPath Inbox -ResultSize Unlimited

# 遍历所有邮件和附件
foreach ($email in $emails) {
    Write-Host "正在处理邮件：$($email.Subject)"
    foreach ($attachment in $email.Attachments) {
        # 跳过内嵌附件（比如邮件签名里的图片）
        if ($attachment.IsInline -eq $false) {
            $attachmentFullPath = Join-Path $downloadPath $attachment.Name
            
            # 处理重名文件：自动添加序号
            $counter = 1
            while (Test-Path $attachmentFullPath) {
                $fileName = [System.IO.Path]::GetFileNameWithoutExtension($attachment.Name)
                $extension = [System.IO.Path]::GetExtension($attachment.Name)
                $attachmentFullPath = Join-Path $downloadPath "$fileName($counter)$extension"
                $counter++
            }

            # 尝试下载附件，捕获错误
            try {
                $attachment.SaveAsFile($attachmentFullPath)
                Write-Host "✅ 成功下载：$attachmentFullPath"
            }
            catch {
                Write-Warning "❌ 下载失败 $($attachment.Name)：$($_.Exception.Message)"
                # 继续处理下一个附件，不中断脚本
                continue
            }
        }
    }
}

Write-Host "所有附件处理完成！"

最后排查步骤 #

1. 优先检查获取邮件的命令是否添加了-ResultSize Unlimited
2. 查看循环逻辑里有没有break、Select-Object -First 10这类限制代码
3. 给脚本加上错误处理，避免中途意外中断

内容的提问来源于stack exchange，提问作者Coburn Butler