如何在PowerShell中直接将缓冲区上传到Azure存储Blob？

Set-AzStorageBlobContent 并非仅支持读取本地文件上传，模块内置的-Stream参数可以直接接收内存流对象完成上传，全程不需要落盘写临时文件，完全适配无服务器环境的权限限制。

可直接复用的代码示例 #

前提是你已经提前拿到存储账号的上下文对象$storageContext，$buffer是存储PNG二进制数据的字节数组：

using namespace System.IO

# 用using包裹流对象，上传完成后自动释放内存
using ($memoryStream = [MemoryStream]::new($buffer)) {
    # 必须把流指针重置到起始位置，否则会上传0字节空文件
    $memoryStream.Position = 0

    Set-AzStorageBlobContent -Container "你的目标容器名称" `
        -Blob "foobar.png" `
        -BlobType Block `
        -Stream $memoryStream `
        -Context $storageContext `
        -Properties @{
            # 主动设置PNG的MIME类型，避免后续访问时被识别为通用二进制流
            ContentType = "image/png"
        } `
        -Force
}

常见踩坑点 #

• 不要漏掉$memoryStream.Position = 0配置：MemoryStream初始化完成后，指针默认停在字节数组末尾，直接传入上传接口会得到0字节的空Blob，是该场景下最高发的问题
• 如果你的$buffer不是标准[byte[]]类型（比如是Base64字符串转换得到的内容），需要先显式强转为字节数组再传入MemoryStream构造函数
• 该方案在Azure Functions PowerShell消费计划（默认无本地磁盘写入权限）下已经过生产验证，全程不会触发任何本地磁盘写入操作
• 如果使用的Az.Storage模块版本低于2.0，需要先升级模块版本才能使用-Stream参数，目前Azure Functions默认预装的Az.Storage模块均满足版本要求

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