PowerShell项目实战：三种方法精确测量文件下载时间

2025-06-04 14:09:01作者：董灵辛Dennis

在系统管理和网络运维工作中，准确测量文件下载时间是一项基础但重要的任务。本文将基于PowerShell项目，深入讲解三种不同层级的下载时间测量方法，从最简单的内置命令到最底层的Windows API调用。

一、背景与需求分析

作为系统管理员，我们经常需要排查网络性能问题。传统做法是使用第三方工具，但通过PowerShell原生实现有以下优势：

无需额外安装软件
可集成到自动化脚本中
可自定义测量逻辑
结果易于程序化处理

二、基础方法：使用BITS服务

2.1 BITS服务简介

BITS（Background Intelligent Transfer Service）是Windows提供的后台智能传输服务，特点包括：

支持HTTP/HTTPS和SMB协议
自动处理网络中断和恢复
带宽节流功能
后台传输不干扰前台应用

2.2 实现代码

# 设置进度条不显示
$ProgressPreference = 'SilentlyContinue'
$url = 'https://example.com/testfile.zip'
$iterations = 5
$totalTime = [timespan]::Zero

$stopwatch = [System.Diagnostics.Stopwatch]::new()

for ($i=1; $i -le $iterations; $i++) {
    $tempFile = [System.IO.Path]::GetTempFileName()
    
    $stopwatch.Restart()
    Start-BitsTransfer -Source $url -Destination $tempFile
    $stopwatch.Stop()
    
    Remove-Item $tempFile -Force
    $totalTime = $totalTime.Add($stopwatch.Elapsed)
}

# 计算平均时间
if ($PSVersionTable.PSVersion -ge [version]'6.0') {
    $avgTime = $totalTime.Divide($iterations)
} else {
    $avgTime = [timespan]::new($totalTime.Ticks / $iterations)
}

$avgTime

2.3 优缺点分析

优点：

实现简单
内置重试机制
显示传输进度

缺点：

服务启动有额外开销
结果包含BITS自身处理时间

三、进阶方法：使用.NET类库

3.1 HttpWebRequest原理

System.Net.HttpWebRequest提供了更底层的HTTP协议实现：

创建请求对象
获取响应流
创建文件流
分段读写数据
释放资源

3.2 实现代码

$uri = [uri]'https://example.com/testfile.zip'
$bufferSize = 10KB
$iterations = 5
$totalTime = [timespan]::Zero

$stopwatch = [System.Diagnostics.Stopwatch]::new()

for ($i=1; $i -le $iterations; $i++) {
    $tempFile = [System.IO.Path]::GetTempFileName()
    
    $request = [System.Net.HttpWebRequest]::Create($uri)
    $request.Timeout = 15000
    
    $stopwatch.Restart()
    
    $response = $request.GetResponse()
    $stream = $response.GetResponseStream()
    $fileStream = [System.IO.FileStream]::new($tempFile, 'Create')
    
    $buffer = [byte[]]::new($bufferSize)
    do {
        $read = $stream.Read($buffer, 0, $buffer.Length)
        $fileStream.Write($buffer, 0, $read)
    } while ($read -gt 0)
    
    $stopwatch.Stop()
    $totalTime = $totalTime.Add($stopwatch.Elapsed)
    
    $fileStream.Dispose()
    $stream.Dispose()
    Remove-Item $tempFile -Force
}

# 计算平均时间...

3.3 性能对比

测试10次迭代结果：

方法	平均耗时(ms)
BITS	657
HttpWebRequest	315

四、底层方法：调用Windows API

4.1 WinHTTP API简介

WinHTTP是Windows提供的HTTP客户端API，特点包括：

比.NET更接近操作系统层
支持同步/异步操作
提供更精细的控制

4.2 C#封装实现

首先创建WinHttpHelper.cs：

using System;
using System.IO;
using System.Runtime.InteropServices;

public class WinHttpHelper
{
    [DllImport("winhttp.dll", SetLastError=true)]
    public static extern IntPtr WinHttpOpen(
        string pwszUserAgent, 
        uint dwAccessType,
        string pwszProxyName, 
        string pwszProxyBypass, 
        uint dwFlags);
    
    // 其他API声明...
    
    public static void DownloadFile(Uri uri, string savePath)
    {
        // 实现完整的下载逻辑
    }
}

4.3 PowerShell调用

Add-Type -Path "WinHttpHelper.cs"

$stopwatch = [System.Diagnostics.Stopwatch]::StartNew()
[WinHttpHelper]::DownloadFile("https://example.com/testfile.zip", "C:\temp\test.zip")
$stopwatch.Stop()

$stopwatch.Elapsed

4.4 性能对比

加入WinHTTP后的测试结果：

方法	平均耗时(ms)
BITS	657
HttpWebRequest	281
WinHTTP	249
WinHTTP(C#)	191

五、实用扩展：计算下载速度

function Get-DownloadSpeed {
    param(
        [uri]$Url,
        [int]$Iterations = 3
    )
    
    # 获取文件大小
    $size = ([System.Net.HttpWebRequest]::Create($url).GetResponse().ContentLength
    
    # 执行下载测试(选择任一方法)
    $time = Measure-DownloadTime -Url $url -Iterations $iterations
    
    # 计算速度
    $bps = $size / $time.TotalSeconds
    
    # 转换为友好格式
    if ($bps -gt 1TB) {
        $speed = "{0:N2} TB/s" -f ($bps/1TB)
    }
    elseif ($bps -gt 1GB) {
        $speed = "{0:N2} GB/s" -f ($bps/1GB)
    }
    elseif ($bps -gt 1MB) {
        $speed = "{0:N2} MB/s" -f ($bps/1MB)
    }
    elseif ($bps -gt 1KB) {
        $speed = "{0:N2} KB/s" -f ($bps/1KB)
    }
    else {
        $speed = "$bps B/s"
    }
    
    [PSCustomObject]@{
        Size = "$([math]::Round($size/1MB,2)) MB"
        Time = $time
        Speed = $speed
    }
}