Invoke-Command传参及远程创建多快捷方式失败问题求助

嘿，我来帮你搞定这两个PowerShell的问题，都是远程执行场景里很常见的坑，我给你拆解清楚：

Invoke-Command传参有三种常用姿势，覆盖不同版本的PowerShell需求，你按需选就行：

1. 用-ArgumentList兼容全版本
   这是最通用的写法，适合所有PowerShell版本。注意如果要传递数组作为单个参数，得把它包在另一个数组里（避免被拆成单个元素）：

# 定义本地参数
$param1 = "报表文件"
$param2 = 2024
$param3 = @("C:\file1.exe", "C:\file2.exe")

# 远程执行
Invoke-Command -ComputerName RemotePC01 -ScriptBlock {
    param($p1, $p2, $p3)
    Write-Host "收到参数1: $p1"
    Write-Host "收到参数2: $p2"
    Write-Host "收到数组参数: $($p3 -join ', ')"
} -ArgumentList $param1, $param2, (,$param3)

2. 用$using:简化传参（PS3.0+）
   PowerShell 3.0及以上版本可以直接在远程脚本块里引用本地变量，不用显式传参，非常省心：

# 本地变量
$localUserName = "Pavel"
$localTargetPaths = @("C:\app1.exe", "C:\app2.exe")

# 远程调用直接用$using:前缀引用
Invoke-Command -ComputerName RemotePC01 -ScriptBlock {
    Write-Host "当前操作的用户名: $using:localUserName"
    Write-Host "要处理的路径: $($using:localTargetPaths -join ', ')"
}

3. 传递哈希表管理多参数
   如果参数特别多，用哈希表打包会更清晰，不容易搞混顺序：

# 打包成哈希表
$userParams = @{
    Name = "Pavel"
    Age = 30
    TargetApps = @("C:\code.exe", "C:\note.exe")
}

# 远程接收
Invoke-Command -ComputerName RemotePC01 -ScriptBlock {
    param($params)
    Write-Host "姓名: $($params.Name), 年龄: $($params.Age)"
    Write-Host "目标应用: $($params.TargetApps -join ', ')"
} -ArgumentList $userParams

先给你分析脚本里的几个潜在坑，再给你修正后的版本：

问题根源 #

1. 你的add-sc函数用了PROCESS块，这个块是为管道输入设计的，如果直接传数组参数，它不会自动遍历数组元素，反而会把整个数组当成单个输入对象处理；
2. $Home\Desktop在远程会话中指向的是远程执行用户的桌面，如果路径权限有问题或者路径不存在，后面的快捷方式会静默失败；
3. $a.Substring($a.length -5)的写法不安全，如果目标路径长度不足5会报错，而且获取文件名的方式不够可靠。

修正后的脚本 #

我把函数改成更直接的遍历逻辑，同时用更可靠的方式获取桌面路径和文件名：

$Servers = Get-Content D:\1.txt
$Targets = @("C:\path1.exe", "C:\path2.exe") # 你的目标路径数组

# 远程执行脚本块
Invoke-Command -ComputerName $Servers -ScriptBlock {
    # 重新定义函数，去掉不必要的BEGIN/PROCESS/END块
    function add-sc {
        param ([string[]]$Targets)
        foreach ($a in $Targets) {
            try {
                $WshShell = New-Object -comObject WScript.Shell
                # 用Split-Path安全获取文件名
                $fileName = Split-Path $a -Leaf
                # 用系统API获取可靠的桌面路径
                $desktopPath = [Environment]::GetFolderPath('Desktop')
                $shortcutFullPath = Join-Path -Path $desktopPath -ChildPath "$fileName.lnk"

                $Shortcut = $WshShell.CreateShortcut($shortcutFullPath)
                $Shortcut.TargetPath = $a
                $Shortcut.Save()
                Write-Host "成功创建快捷方式: $shortcutFullPath"
            }
            catch {
                Write-Host "创建$a的快捷方式失败: $_"
            }
        }
    }
    # 调用函数，用$using:直接引用本地的Targets数组
    add-sc -Targets $using:Targets
}

额外排查建议 #

• 执行时加上-ErrorAction Stop或者在循环里加try/catch，能快速定位第二个路径的失败原因；
• 确认远程执行的用户对桌面路径有写入权限，有时候用管理员身份执行反而会写到管理员的桌面，不是当前用户的。

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