如何将AzCopy递归同步命令转换为Azure Runbook可执行命令

原AzCopy命令不需要完全重写为PowerShell原生命令，Runbook环境原生支持直接调用AzCopy，是最匹配原命令逻辑的方案；如果要求纯PowerShell cmdlet实现，可使用新版Az存储模块编写递归逻辑。

方案1：Runbook直接调用AzCopy（推荐，和原命令逻辑100%一致） #

Azure Automation官方沙箱运行环境已预装AzCopy，无需额外上传可执行文件，操作步骤如下：

• 为Runbook绑定的系统分配托管标识配置权限：源存储账号授予存储Blob数据读取者角色，目标存储账号授予存储Blob数据参与者角色
• 直接在PowerShell类型Runbook中运行以下代码：

# 适配不同运行时版本的AzCopy默认路径
$azCopyExe = if ($isLinux) {
    "/usr/bin/azcopy"
} else {
    "${env:ProgramFiles(x86)}\Microsoft SDKs\Azure\AzCopy\azcopy.exe"
}

# 用托管标识完成AzCopy身份验证，无需硬编码SAS/密钥
& $azCopyExe login --identity

# 替换为实际源、目标Blob地址
$sourceUri = "https://xxxxxx.blob.core.windows.net/xxxxx/...."
$targetUri = "https://xxxxxx.blob.core.windows.net/xxxxx/...."

# 执行原命令等效的递归同步操作
& $azCopyExe sync $sourceUri $targetUri --recursive

如果使用混合Runbook工作器运行，提前在工作器节点安装AzCopy并加入系统环境变量后，可直接调用azcopy命令无需写全路径。

方案2：纯Az.Storage模块实现（不依赖外部可执行文件） #

之前使用Start-AzureStorageBlobCopy运行失败的核心原因是该cmdlet属于已废弃的旧AzureRM模块，本身不支持跨账号传入全Blob URI，也无内置递归枚举逻辑，需要替换为新版Az模块的Copy-AzStorageBlob并自行实现递归遍历、增量判断逻辑，参考代码如下：

# 用Runbook托管标识登录Azure
Connect-AzAccount -Identity | Out-Null

# 替换为实际存储配置
$sourceConfig = @{
    StorageAccountName = "源存储账号名"
    ContainerName = "源容器名"
    PathPrefix = "源目录前缀，根目录留空"
}
$targetConfig = @{
    StorageAccountName = "目标存储账号名"
    ContainerName = "目标容器名"
    PathPrefix = "目标目录前缀，根目录留空"
}

# 生成存储上下文
$sourceCtx = New-AzStorageContext -StorageAccountName $sourceConfig.StorageAccountName -UseConnectedAccount
$targetCtx = New-AzStorageContext -StorageAccountName $targetConfig.StorageAccountName -UseConnectedAccount

# 递归获取源路径下所有Blob
$allSourceBlobs = Get-AzStorageBlob -Container $sourceConfig.ContainerName -Prefix $sourceConfig.PathPrefix -Context $sourceCtx

# 增量同步：仅复制目标不存在、或大小/修改时间不匹配的Blob
foreach ($blob in $allSourceBlobs) {
    $targetBlobName = $blob.Name.Replace($sourceConfig.PathPrefix, $targetConfig.PathPrefix)
    $existingTargetBlob = Get-AzStorageBlob -Blob $targetBlobName -Container $targetConfig.ContainerName -Context $targetCtx -ErrorAction SilentlyContinue
    
    $needCopy = $false
    if (-not $existingTargetBlob) {
        $needCopy = $true
    } elseif ($existingTargetBlob.Length -ne $blob.Length -or $existingTargetBlob.LastModified.UtcDateTime -lt $blob.LastModified.UtcDateTime) {
        $needCopy = $true
    }

    if ($needCopy) {
        Copy-AzStorageBlob -SrcBlob $blob.Name -SrcContainer $sourceConfig.ContainerName -Context $sourceCtx `
            -DestBlob $targetBlobName -DestContainer $targetConfig.ContainerName -DestContext $targetCtx -Force
    }
}

该方案在Blob总量超过10万时枚举、传输效率远低于AzCopy，且没有AzCopy内置的并发控制、失败重试、断点续传能力，仅适用于小数据量场景。

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