Azure Function（PowerShell）访问存储账户：找不到CloudStorageAccount类型

你遇到的Unable to find type [CloudStorageAccount]错误，核心原因是：

• 你使用的Microsoft.WindowsAzure.Storage是已弃用的旧版存储客户端库，Azure Functions的PowerShell运行时默认不会预加载这个程序集；
• 即使添加using namespace声明，若未先加载对应的.NET程序集，PowerShell依然无法识别这些类型。

推荐使用官方当前支持的Az.Storage模块操作存储账户，这是PowerShell Azure Functions中访问存储的标准方式，以下是具体方案：

方法一：使用Az.Storage模块（推荐） #

1. 启用Az模块支持：
   • 在Function App配置中，将FUNCTIONS_POWERSHELL_ENABLE_AZURE_MODULES设为true；
   • 或在requirements.psd1中声明依赖的Az.Storage版本，示例：

     @{
         Az.Storage = "5.xx.x" # 替换为最新稳定版
     }
     

2. 替换原有代码逻辑：

   # 方式1：使用连接字符串
   $connectionString = "DefaultEndpointsProtocol=https;AccountName=example;AccountKey=example"
   $storageContext = New-AzStorageContext -ConnectionString $connectionString
   
   $container = Get-AzStorageContainer -Name "xyz" -Context $storageContext
   $blobName = "$jobId.xml"
   $blob = Get-AzStorageBlob -Container "xyz" -Blob $blobName -Context $storageContext
   
   # 方式2：使用托管身份（更安全，无需暴露密钥）
   $storageContext = New-AzStorageContext -StorageAccountName "example" -UseConnectedAccount
   $container = Get-AzStorageContainer -Name "xyz" -Context $storageContext
   $blob = Get-AzStorageBlob -Container "xyz" -Blob $blobName -Context $storageContext
   

方法二：手动加载旧版程序集（不推荐） #

若必须使用旧的Microsoft.WindowsAzure.Storage库，需手动加载程序集：

1. 将Microsoft.WindowsAzure.Storage NuGet包中的Microsoft.WindowsAzure.Storage.dll上传至Function App的bin目录；
2. 在代码开头添加加载语句：

   Add-Type -Path "$PSScriptRoot\bin\Microsoft.WindowsAzure.Storage.dll"
   using namespace Microsoft.WindowsAzure.Storage
   using namespace Microsoft.WindowsAzure.Storage.Blob
   
   # 原有代码可正常运行
   $storageAccount = [CloudStorageAccount]::Parse("DefaultEndpointsProtocol=https;AccountName=example;AccountKey=example")     
   $blobClient = $storageAccount.CreateCloudBlobClient()
   $container = $blobClient.GetContainerReference("xyz")
   $blobName = "$jobId.xml"
   $blob = $container.GetBlockBlobReference($blobName)
   

   注意：该方式已被官方弃用，后续可能出现兼容性问题，不建议用于生产环境。

• 优先使用Az模块，它是Azure PowerShell的官方主流模块，持续更新且兼容Azure Functions运行环境；
• 避免硬编码存储账户密钥，优先使用托管身份或Azure Key Vault管理凭据，提升安全性。

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