使用Azure Runbook删除Azure文件共享旧文件时如何从文件列表获取文件元数据

• 现有脚本存在两处核心设计错误，导致无法获取有效的LastModified值：
  1. 用Get-AzureStorageFileContent枚举文件列表完全不符合使用场景：该命令的作用是将文件内容下载到本地路径，返回的本地文件对象本身不携带Azure云端的元数据结构，自然无法读取云端的最后修改时间
  2. Azure文件共享的列表接口设计和Blob存储存在差异：默认列表返回结果不会把LastModified字段填充到对象属性中，必须对单个文件显式调用Get file metadata接口拉取完整属性，才能拿到准确的修改时间
• 原脚本还存在变量名不匹配的bug：定义的阈值变量为$date_before_blobs_to_be_deleted，但删除判断逻辑里引用了未定义的$date_before_files_to_be_deleted，会触发空值比较错误。

核心调整逻辑 #

• 移除无意义的文件下载类命令，改用递归模式的Get-AzureStorageFile遍历所有子目录下的文件
• 对每个枚举到的文件对象，调用SDK封装的FetchAttributes()方法（对应官方Get file metadata操作），触发元数据拉取并填充LastModified字段
• 直接传递已枚举到的文件对象执行删除操作，避免手动拼接路径时的转义错误。

## 基础变量定义
$number_of_days_threshold = 20
$current_date = Get-Date
$delete_before_date = $current_date.AddDays(-$number_of_days_threshold)
$file_count_deleted = 0

# 存储账户配置
$storage_account_name = "你的存储账户名" 
$storage_account_key = "你的存储账户密钥"
$ShareName = "你的文件共享名"

# 生成存储访问上下文
$context = New-AzureStorageContext -StorageAccountName $storage_account_name -StorageAccountKey $storage_account_key

# 日志配置
$log_file_name = "log-" + (Get-Date).ToString().Replace('/','-').Replace(' ','-').Replace(':','-') + ".txt"
$local_log_path = Join-Path $env:TEMP $log_file_name
Write-Host "日志文件存储路径: $local_log_path" -ForegroundColor Green

# 递归遍历文件共享下所有层级对象，仅保留文件类型、过滤目录对象
$all_files = Get-AzureStorageFile -Context $context -ShareName $ShareName -Recurse | Where-Object { $_.GetType().Name -eq "CloudFile" }

foreach ($file_item in $all_files) {
    # 调用Get file metadata接口拉取属性，自动填充LastModified字段
    $file_item.FetchAttributes()
    $file_last_modified = $file_item.Properties.LastModified.UtcDateTime

    # 判定是否超出保留期限
    if ($file_last_modified -le $delete_before_date) {
        # 写入运行日志
        "-----------------------------------" | Out-File $local_log_path -Append
        "待删除文件: $($file_item.Name)" | Out-File $local_log_path -Append
        "文件最后修改时间(UTC): $file_last_modified" | Out-File $local_log_path -Append
        "-----------------------------------`n" | Out-File $local_log_path -Append

        # 执行删除操作
        Remove-AzureStorageFile -File $file_item -Context $context
        $file_count_deleted++
    }
}

"本次运行共删除文件数: $file_count_deleted" | Out-File $local_log_path -Append

• 不要用Get-AzureStorageFileContent枚举文件：该命令会产生不必要的出站流量下载文件内容，完全无法获取云端元数据
• 必须对每个枚举到的文件对象调用FetchAttributes()方法：这是Azure文件共享场景下获取LastModified的唯一可靠路径，和Blob存储列表默认返回完整属性的逻辑有本质差异
• 递归枚举时必须过滤CloudFileDirectory类型的目录对象，否则会误对目录触发属性拉取、删除操作，抛出类型不匹配的报错
• Runbook运行时注意将存储上下文的权限校验配置为存储账户密钥或共享访问签名，避免跨资源权限报错。

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