如何通过Rest-API在Airwatch/Workspace ONE中设置设备名称与友好名称

解决方案 #

你尝试直接修改DeviceName和DeviceReportedName不生效是正常的，这两个字段属于iOS设备上报给Workspace ONE UEM的只读属性，API默认不开放直接写入权限，所有修改请求都会被系统忽略。

你提到的「将Friendly Name作为Device Name使用」的开关可以通过API直接开启，对应是租户级的UseFriendlyNameAsDeviceName配置项，调用示例如下：

$requestHeaders = @{
   'Accept' = 'application/json'
   'Authorization' = $auth
   'aw-tenant-code' = $wsoApiKey
}
# 替换groupId为你实际操作的租户ID
$uri = "$wsoApiUri/system/settings/general/device?groupId=$yourTenantId"
$body = @{
    "UseFriendlyNameAsDeviceName" = $true
} | ConvertTo-Json
Invoke-RestMethod -Uri $uri -ContentType "application/json; charset=utf-8" -Headers $requestHeaders -Body $body -Method Put

开启该配置后，你原有修改DeviceFriendlyName的请求会自动同步更新对应设备的Device Name字段，不需要额外开发其他逻辑。

如果不想开启全局同步规则，仅需要修改特定设备的Device Name，可以用自定义属性+配置文件的方案实现：

• 调用POST /api/mdm/devices/{deviceId}/customattributes接口给目标设备写入自定义的设备名称值
• 配置包含自定义属性变量的设备命名配置文件，推送给对应设备即可完成名称更新

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