使用PowerShell在Kepware中写入OPC标签值时遇400错误求助

你的代码存在几个关键问题，导致了400 Bad Request错误，以下是修正方案：

1. 修正API端点 #

Kepware的/config/v1路径用于修改标签的配置信息（比如名称、数据类型），要写入标签的实时值，必须使用/data/v1数据API端点。正确的URL格式应为：

$kepwareServerUrl = 'http://localhost:57412/data/v1/project/channels/Channel1/devices/Device1/tags/Tag2'

或者更简洁的格式：

$kepwareServerUrl = 'http://localhost:57412/data/v1/tags/Channel1.Device1.Tag2'

2. 修复URL的换行空格 #

你的URL被拆成两行，导致字符串中包含多余空格，必须合并为一行，避免路径解析错误。

3. 调整Payload格式 #

Kepware数据API要求写入值的Payload使用value字段（而非v），如果标签是布尔型或字符串，需确保值的类型匹配：

$payload = @{
    "value" = $newValue
} | ConvertTo-Json -Compress

添加-Compress可以避免JSON格式中的换行，减少请求错误概率。

4. 修复认证头的格式问题 #

你的Authorization头字符串因换行产生了多余空格，需确保Basic和编码后的凭证是连续的，无换行：

$headers = @{
    Authorization = "Basic $encodedCredentials"
}

5. 简化错误逻辑 #

try/catch已经能捕获请求错误，无需额外判断$response是否为null，避免重复输出提示。

修正后的完整代码 #

# 正确的数据API端点
$kepwareServerUrl = 'http://localhost:57412/data/v1/project/channels/Channel1/devices/Device1/tags/Tag2'
$newValue = 10

# 符合API要求的Payload
$payload = @{
    "value" = $newValue
} | ConvertTo-Json -Compress

# 认证信息处理
$username = "Administrator"
$password = ""
$encodedCredentials = [Convert]::ToBase64String([Text.Encoding]::ASCII.GetBytes("${username}:${password}"))
$headers = @{ Authorization = "Basic $encodedCredentials" }

Write-Host "Payload: $payload"
Write-Host "URL: $kepwareServerUrl"

try {
    $response = Invoke-RestMethod -Uri $kepwareServerUrl -Method Put -Body $payload -ContentType "application/json" -Headers $headers
    Write-Host "Tag值更新成功。"
} 
catch {
    # 输出详细错误信息，方便排查
    Write-Host "更新失败，错误详情："
    Write-Host "状态码: $($_.Exception.Response.StatusCode.value__)"
    Write-Host "错误信息: $($_.Exception.Message)"
    # 如果有响应内容，也可以输出
    if ($_.Exception.Response) {
        $reader = New-Object System.IO.StreamReader($_.Exception.Response.GetResponseStream())
        $responseBody = $reader.ReadToEnd()
        Write-Host "响应内容: $responseBody"
    }
}

额外排查要点 #

• 确保Kepware的REST API服务已启用：在Kepware管理控制台中，进入Settings > REST API，确认“Enable REST API”已勾选，且端口（默认57412）正确。
• 检查标签路径是否正确：确认Channel1、Device1、Tag2的名称完全匹配，注意大小写敏感。
• 验证用户权限：Administrator账号需拥有标签的写权限，若启用了Kepware的安全策略，需确保账号权限足够。

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