删除 targetDeviceGroup

命名空间：microsoft.graph

删除 servicePrincipal 上 remoteDesktopSecurityConfiguration 对象的 targetDeviceGroup 对象。

使用 Microsoft Entra ID 远程桌面服务 (RDS) 身份验证协议 的任何用户都不会收到 SSO 提示，该协议Microsoft Entra 已加入 或 Microsoft Entra 混合加入 的设备。

权限

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

权限类型	最低特权权限	更高特权权限
委派（工作或学校帐户）	Application-RemoteDesktopConfig.ReadWrite.All	Application.ReadWrite.All、Directory.ReadWrite.All
委派（个人 Microsoft 帐户）	不支持。	不支持。
应用程序	Application-RemoteDesktopConfig.ReadWrite.All	Application.ReadWrite.All、Application.ReadWrite.OwnedBy、Directory.ReadWrite.All

在具有工作或学校帐户的委派方案中，登录用户必须是组的所有者或成员，或者分配有受支持的 Microsoft Entra 角色 或具有支持的角色权限的自定义角色。 此操作支持以下最低特权角色。

• 应用程序管理员*
• 云应用程序管理员

HTTP 请求

DELETE /servicePrincipals/{servicePrincipalsId}/remoteDesktopSecurityConfiguration/targetDeviceGroups/{targetDeviceGroupId}/$ref

请求标头

名称	说明
Authorization	持有者 {token}。 必填。 详细了解 身份验证和授权。

请求正文

请勿提供此方法的请求正文。

响应

如果成功，此方法返回 204 No Content 响应代码。

示例

请求

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

HTTP

DELETE https://graph.microsoft.com/v1.0/servicePrincipals/00af5dfb-85da-4b41-a677-0c6b86dd34f8/remoteDesktopSecurityConfiguration/targetDeviceGroups/1a9db3ab-0acf-4808-99ae-e8ed581cb2e0/$ref

JavaScript

const options = {
	authProvider,
};

const client = Client.init(options);

await client.api('/servicePrincipals/00af5dfb-85da-4b41-a677-0c6b86dd34f8/remoteDesktopSecurityConfiguration/targetDeviceGroups/1a9db3ab-0acf-4808-99ae-e8ed581cb2e0/$ref')
	.delete();

有关如何将 SDK 添加到项目并创建 authProvider 实例的详细信息，请参阅 SDK 文档。

响应

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

HTTP/1.1 204 No Content