cloudPC: setDeviceName

命名空间:microsoft.graph

重要

Microsoft Graph /beta 版本下的 API 可能会发生更改。 不支持在生产应用程序中使用这些 API。 若要确定 API 是否在 v1.0 中可用,请使用 版本 选择器。

设置 云电脑的操作系统设备名称。 此操作异步运行并更改计算机名称,而不是 displayName 属性。 若要更改显示名称,请使用 rename。

此操作支持处于专用模式的 Windows 365 企业版和 Windows 365 Flex (以前称为一线) 云电脑。 使用 getSupportedCloudPcRemoteActions 检查操作是否适用于云电脑。

API 可用性

此 API 可用于以下国家级云部署。

全局服务 美国政府 L4 美国政府 L5 (DOD) 由世纪互联运营的中国
✅ ✅ ✅ ❌

权限

为此 API 选择标记为最低特权的权限。 只有在应用需要它时,才使用更高的特权权限。 有关委派权限和应用程序权限的详细信息,请参阅权限类型。 要了解有关这些权限的详细信息,请参阅 权限参考。

权限类型 最低特权权限 更高特权权限
委派(工作或学校帐户) CloudPC.ReadWrite.All 不可用。
委派(个人 Microsoft 帐户) 不支持。 不支持。
应用程序 CloudPC.ReadWrite.All 不可用。

注意

对于使用工作或学校帐户的委派访问权限,登录用户除了拥有 Microsoft Graph 权限外,还必须具有 CloudPCs/SetDeviceName 通过 Windows 365 基于角色的访问控制的权限。 可以使用 云电脑管理员 角色或授予此权限的自定义角色。 支持的 Microsoft Entra 角色包括“ Windows 365 管理员 ”和“ Intune 管理员”。

对于作用域角色分配,目标云电脑也必须位于用户分配的作用 域组 和 作用域标记内。 这些用户角色要求不适用于仅限应用程序的访问。

HTTP 请求

POST /deviceManagement/virtualEndpoint/cloudPCs/{cloudPC-id}/setDeviceName

请求标头

名称 说明
Authorization 持有者 {token}。 必填。 详细了解 身份验证和授权。
Content-Type application/json. 必需。

请求正文

在请求正文中,提供参数的 JSON 表示形式。

下表列出了调用此操作时所需的参数。

参数 类型 说明
deviceName String 要分配给云电脑的设备名称。 必填。 必须为 5-15 个字符,并且仅包含 ASCII 字母、数字或连字符。 名称不能完全由数字组成,并且在租户中必须是唯一的。 使用不以连字符开头的名称。

响应

如果成功,此操作返回 204 No Content 响应代码。 成功的响应并不意味着设备名称已更改,也不意味着 Intune 同步了该更改。 使用 retrieveCloudPcRemoteActionResults 检查远程操作结果。

示例

请求

以下示例显示了一个请求。

POST https://graph.microsoft.com/beta/deviceManagement/virtualEndpoint/cloudPCs/b0a9cde2-e170-4dd9-97c3-ad1d3328a711/setDeviceName
Content-Type: application/json

{
  "deviceName": "CPC-SALES01"
}

响应

以下示例显示了相应的响应。

HTTP/1.1 204 No Content