在PowerShell Runbook中使用Azure文件共享的实现方法问询

我完全理解你遇到的困境：本地或网络共享环境下，PnP模板里的<xi:include>相对路径能正常解析，但到了Azure自动化Runbook里，SMB挂载用不了，New-PSDrive也因为环境限制没法正常工作。最直接的可行方案就是把Azure文件共享里的所有文件（包含完整目录结构）递归复制到Runbook的临时文件夹，这样模板里的相对路径就能和本地环境一样正常使用了。

具体实现步骤 #

1. 准备权限与依赖 #

确保你的Runbook使用的身份（托管标识或服务主体）拥有目标Azure存储账户的Storage File Data SMB Share Contributor权限（或更高权限），这样才能读取文件共享中的内容。同时确认Runbook环境已经导入Az.Storage模块（Azure自动化默认预装了常用模块，若缺失可手动导入）。

2. 递归复制文件到临时目录 #

下面是完整的PowerShell脚本，会把Azure文件共享的所有文件和目录结构完整同步到Runbook的$env:TEMP目录：

# 配置你的存储账户信息
$storageAccountName = "你的存储账户名称"
$resourceGroupName = "存储账户所在的资源组名称"
$fileShareName = "目标文件共享名称"
$tempDirectory = $env:TEMP

# 获取存储账户密钥并创建存储上下文
$storageAccountKey = (Get-AzStorageAccountKey -ResourceGroupName $resourceGroupName -Name $storageAccountName).Value[0]
$storageContext = New-AzStorageContext -StorageAccountName $storageAccountName -StorageAccountKey $storageAccountKey

# 定义递归复制函数
function Sync-AzureFileShareToTemp {
    param(
        [Parameter(Mandatory=$true)]
        [string]$ShareName,
        [Parameter(Mandatory=$true)]
        [string]$LocalRootPath,
        [Parameter(Mandatory=$true)]
        [Microsoft.WindowsAzure.Commands.Common.Storage.AzureStorageContext]$StorageContext,
        [string]$ShareRelativePath = ""
    )

    # 获取当前共享路径下的所有文件和子目录
    $shareItems = Get-AzStorageFile -ShareName $ShareName -Path $ShareRelativePath -Context $StorageContext
    $subDirectories = $shareItems | Where-Object { $_ -is [Microsoft.WindowsAzure.Commands.Storage.Model.ResourceModel.AzureStorageFileDirectory] }
    $files = $shareItems | Where-Object { $_ -is [Microsoft.WindowsAzure.Commands.Storage.Model.ResourceModel.AzureStorageFile] }

    # 创建对应的本地目录
    $localTargetPath = Join-Path -Path $LocalRootPath -ChildPath $ShareRelativePath
    if (-not (Test-Path -Path $localTargetPath)) {
        New-Item -ItemType Directory -Path $localTargetPath | Out-Null
    }

    # 复制当前路径下的所有文件
    foreach ($file in $files) {
        $localFilePath = Join-Path -Path $localTargetPath -ChildPath $file.Name
        Get-AzStorageFileContent -ShareName $ShareName -Path (Join-Path $ShareRelativePath $file.Name) `
            -Context $StorageContext -Destination $localFilePath -Force
    }

    # 递归处理子目录
    foreach ($dir in $subDirectories) {
        $newSharePath = Join-Path -Path $ShareRelativePath -ChildPath $dir.Name
        Sync-AzureFileShareToTemp -ShareName $ShareName -LocalRootPath $LocalRootPath `
            -StorageContext $StorageContext -ShareRelativePath $newSharePath
    }
}

# 执行同步操作
Sync-AzureFileShareToTemp -ShareName $fileShareName -LocalRootPath $tempDirectory -StorageContext $storageContext

# 切换到临时目录，执行你的PnP模板处理脚本
Set-Location -Path $tempDirectory
# 这里替换成你的PnP命令，比如：
# Apply-PnPProvisioningTemplate -Path "./你的模板文件.xml"

为什么其他方法不可行？ #

• SMB映射失败：Azure自动化的Runbook运行在沙箱环境中，未启用SMB相关系统服务，所以New-SmbMapping会报错"指定的服务不存在"，这是环境固有限制，无法通过配置解决。
• New-PSDrive问题：Azure自动化环境对.NET更新和第三方模块安装有严格的权限限制，而且基于SMB的PSDrive本质依赖和SMB映射相同的服务，同样会失败。

注意事项 #

• Runbook执行结束后，$env:TEMP目录会被自动清理，无需手动删除文件。
• 如果文件共享内容较大，要注意Runbook的执行时间限制（默认最大3小时），若超出可考虑拆分同步任务或使用异步方式处理。
• 若使用托管标识代替存储账户密钥，可将创建存储上下文的代码替换为：

  $storageContext = New-AzStorageContext -StorageAccountName $storageAccountName -UseConnectedAccount
  

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