通过PowerShell按需远程设置壁纸遇参数错误求助

问题描述 #

已创建如下PowerShell函数：

Function Set-WallPaper($Value)
{
    Set-ItemProperty -path 'HKCU:\Control Panel\Desktop\' -name wallpaper -value $value
    rundll32.exe user32.dll, UpdatePerUserSystemParameters
}

本地执行Set-Wallpaper -value "\\server\share\image.jpg"可正常设置壁纸，但通过以下命令远程执行时：

Invoke-Command -ComputerName TARGETPC Set-Wallpaper -value "\\server\share\image.jpg"

报错：Invoke-Command : A parameter cannot be found that matches parameter name 'value'.

原因分析 #

你错误地将Set-Wallpaper和-value直接作为Invoke-Command的参数传递了。PowerShell会把Set-Wallpaper识别为Invoke-Command的位置参数，而-value并非Invoke-Command的内置参数，因此触发参数不匹配的错误。

解决方法 #

情况1：目标机器已存在Set-Wallpaper函数 #

需要将执行命令放在-ScriptBlock参数中，正确写法如下：

Invoke-Command -ComputerName TARGETPC -ScriptBlock { Set-Wallpaper -value "\\server\share\image.jpg" }

注意：如果目标机器的当前用户无法访问\\server\share共享路径，可能出现权限问题，需确保远程会话有该共享的访问权限。

情况2：目标机器不存在Set-Wallpaper函数 #

需先将函数定义传递到远程机器，再执行调用，可通过-ArgumentList传递壁纸路径：

Invoke-Command -ComputerName TARGETPC -ScriptBlock {
    Function Set-WallPaper($Value)
    {
        Set-ItemProperty -path 'HKCU:\Control Panel\Desktop\' -name wallpaper -value $value
        rundll32.exe user32.dll, UpdatePerUserSystemParameters
    }
    Set-Wallpaper -value $args[0]
} -ArgumentList "\\server\share\image.jpg"

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