rest - 如何通过 Rest-API 在 Airwatch/Workspace ONE 中设置设备名称(友好名称)
问题描述
我希望通过 Rest-API 将 iOS 设备的设备名称和友好名称更改为不同的值。我可以像这样更改友好名称:
$requestHeaders = @{
'Accept' = 'application/json'
'Authorization' = $auth
'aw-tenant-code' = $wsoApiKey
}
$body = @{
'DeviceFriendlyName' = $WsoDeviceName
}
$body = ConvertTo-Json $body
$uri = $wsoApiUri + $WsoDevice.Id.Value
Invoke-RestMethod -Uri $uri -ContentType "application/json; charset=utf-8" -Headers $requestHeaders -Body $body -Method Put
但我似乎无法在本地 API 帮助(位于 server.local/api/help)和 vmwares 文档中找到更改设备名称的正确属性。发送 PUT 请求以更改 DeviceName 或 DeviceReportedName 不会显示任何更改。代码如下:
$body = @{
'DeviceName' = $WsoDeviceName
}
我知道可以通过 Web 界面将友好名称设置为设备名称。也许有一种方法可以通过 API 激活该选项,但我没有找到?在这种情况下,它将完成工作。
如果有人能指出我正确的方向,我会很高兴。
最好的祝福
霍尔瓦施
解决方案
我能够使用自定义 MDM 命令完成此操作。在下面的示例中,我专门使用该POST /devices/commands
方法同时通过设备的序列号搜索。
$MdmCommandXml = [xml]@'
<dict>
<key>RequestType</key>
<string>Settings</string>
<key>Settings</key>
<array>
<dict>
<key>DeviceName</key>
<string></string>
<key>Item</key>
<string>DeviceName</string>
</dict>
</array>
</dict>
'@
$Auth = ""
$WsoApiKey = ""
$BaseUrl = "https://as<yourhostnumber>.awmdm.com/API/mdm"
$SerialNumber = ""
$Uri = "${BaseUrl}/devices/commands?command=CustomMdmCommand&searchBy=Serialnumber&id=${SerialNumber}"
$NewDeviceName = "NewDeviceName"
$MdmCommandXml.SelectSingleNode('//key[.="DeviceName"]/following-sibling::*[1]').InnerXml = $NewDeviceName
$RequestHeaders = @{
'Accept' = 'application/json'
'Authorization' = $Auth
'aw-tenant-code' = $WsoApiKey
}
$Body = @{
'CommandXml' = $MdmCommandXml.OuterXml
}
$Body = ConvertTo-Json $Body
Invoke-RestMethod -Uri $Uri -ContentType "application/json; charset=utf-8" -Headers $RequestHeaders -Body $Body -Method Post
推荐阅读
- swift - 如何在swift中调用mac API“添加新事件”?
- python - 不满足可选依赖项:安装 igraph 和 leidenalg 以使用所选功能
- html - 不透明的 GIF 变透明
- arrays - 在 BigQuery 中选择除 ARRAY_AGG + STRUCT 中的一列之外的所有内容
- c - 如果在同一个套接字上设置多个连接,哪个套接字描述符接收数据?
- python - Pandas Dataframe(内部)加入同一个 Dataframe
- node.js - MongoDB 领域 BadChangeSet 错误:无法验证上传变更集:ProtocolErrorCode=212
- python - 使用python textblob对excel文件数据进行情感分析
- reactjs - div内容过长时如何添加滚动条?反应原生
- python-3.x - 熊猫:数据框的重组