跨域主机带通配符路径：替代Test-Path的凭据访问与文件复制方案

针对你遇到的「需要复制文件到多台主机的特定未知路径、必须使用凭据」的场景，这里有几个适配AzureDevOps管道的实用方案：

方案1：远程定位路径后直接复制 #

核心思路是先通过Invoke-Command远程执行路径搜索，拿到准确的目标文件夹路径，再用UNC路径结合凭据完成复制。

# 配置目标主机列表和凭据（AzureDevOps中建议用服务连接/变量组的安全凭据）
$targetHosts = @("hostA", "hostB")
$cred = Get-Credential # 在管道中可替换为 $(YourCredentialVariable)

foreach ($hostName in $targetHosts) {
    # 远程查询目标文件夹的完整路径
    $targetFullPath = Invoke-Command -ComputerName $hostName -Credential $cred -ScriptBlock {
        # 匹配D盘下所有层级的targetFolder，返回第一个匹配的完整路径
        (Get-ChildItem -Path "D:\*\targetFolder" -Directory | Select-Object -First 1).FullName
    }

    if ($targetFullPath) {
        # 转换为UNC路径格式（比如D:\blah\targetFolder → \\hostA\d$\blah\targetFolder）
        $uncPath = $targetFullPath -replace "^([A-Z]):", "\\$hostName\`$1`$"
        # 替换为你的管道源文件路径，比如$(Build.SourcesDirectory)\yourFile.txt
        $sourceFile = "C:\agent\_work\1\s\yourFile.txt"
        
        Copy-Item -Path $sourceFile -Destination $uncPath -Credential $cred -Force
        Write-Host "文件已成功复制到$hostName的$targetFullPath"
    } else {
        Write-Warning "⚠️ 在主机$hostName上未找到targetFolder"
    }
}

优势： #

• 直接绕过New-PSDrive的通配符限制，逻辑清晰
• 适配AzureDevOps管道的环境变量，容易集成到现有任务中

方案2：映射远程根目录后搜索复制 #

如果需要对远程主机进行多次文件操作，可以先映射远程盘的根目录，再在映射的驱动器内搜索目标文件夹：

$targetHosts = @("hostA", "hostB")
$cred = Get-Credential

foreach ($hostName in $targetHosts) {
    # 映射远程主机的D盘根目录，驱动器名自定义避免冲突
    $driveAlias = "RemoteD_$hostName"
    New-PSDrive -Name $driveAlias -PSProvider FileSystem -Root "\\$hostName\d$" -Credential $cred -Scope Global

    # 在映射的驱动器内查找目标文件夹
    $targetFolder = Get-ChildItem -Path "$driveAlias:\*\targetFolder" -Directory | Select-Object -First 1
    if ($targetFolder) {
        $sourceFile = "$(Build.SourcesDirectory)\yourFile.txt"
        Copy-Item -Path $sourceFile -Destination $targetFolder.FullName -Force
        Write-Host "文件已复制到$hostName的$($targetFolder.FullName)"
    } else {
        Write-Warning "⚠️ 主机$hostName未找到目标文件夹"
    }

    # 清理映射的驱动器，避免占用资源
    Remove-PSDrive -Name $driveAlias -Force
}

注意： #

• 映射的驱动器需要加-Scope Global才能在脚本块外访问
• 记得在循环结束后移除驱动器，避免后续任务冲突

方案3：AzureDevOps原生机器组任务 #

如果你的目标主机已加入AzureDevOps的机器组，可以直接在目标机器上执行任务，跳过跨主机复制的麻烦：

1. 在管道中添加「PowerShell on Target Machines」任务
2. 选择目标机器组，配置WinRM凭据（用服务连接）
3. 在任务脚本中添加以下逻辑：

# 从管道工件拉取源文件（如果文件是构建产出）
$artifactPath = "$(System.ArtifactsDirectory)\YourArtifactName"
$sourceFile = Join-Path $artifactPath "yourFile.txt"

# 查找目标文件夹并复制
$targetPath = (Get-ChildItem -Path "D:\*\targetFolder" -Directory | Select-Object -First 1).FullName
if ($targetPath) {
    Copy-Item -Path $sourceFile -Destination $targetPath -Force
    Write-Host "文件复制完成"
} else {
    Write-Error "未找到targetFolder"
}

优势： #

• 完全利用AzureDevOps的原生能力，无需处理跨主机权限问题
• 直接在目标机器上操作，减少网络传输开销

通用注意事项 #

• 在AzureDevOps中，不要硬编码凭据，使用「服务连接」或「变量组」中的安全变量注入
• 如果存在多个匹配的targetFolder，需要调整脚本逻辑（比如遍历所有匹配路径复制）
• 确保管道代理和目标主机之间的WinRM服务已开启，防火墙允许相关端口通信

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