targetDeviceGroup resource type

Namespace: microsoft.graph

Important

APIs under the /beta version in Microsoft Graph are subject to change. Use of these APIs in production applications is not supported. To determine whether an API is available in v1.0, use the Version selector.

Represents the group of devices configured for the remoteDesktopSecurityConfiguration object on the servicePrincipal. This configuration enables SSO using the Microsoft Entra ID Remote Desktop Services (RDS) authentication protocol, when Microsoft Entra ID authenticates a user to a joined or hybrid joined device that is a member of the targetDeviceGroup.

Inherits from entity.

Methods

Method	Return type	Description
List	targetDeviceGroup collection	Get a list of the targetDeviceGroup objects and their properties for the remoteDesktopSecurityConfiguration object on the servicePrincipal.
Create	targetDeviceGroup	Create a new targetDeviceGroup object for the remoteDesktopSecurityConfiguration object on the servicePrincipal.
Get	targetDeviceGroup	Read the properties and relationships of a targetDeviceGroup object for the remoteDesktopSecurityConfiguration on a servicePrincipal.
Update	targetDeviceGroup	Update the properties of a targetDeviceGroup object for the remoteDesktopSecurityConfiguration on the servicePrincipal.
Delete	None	Delete a targetDeviceGroup object for the remoteDesktopSecurityConfiguration on the servicePrincipal.

Properties

Property	Type	Description
displayName	String	Display name for the target device group.
id	String	Object identifier of the group. Inherited from entity.

Relationships

None.

JSON representation

The following JSON representation shows the resource type.

{
  "@odata.type": "#microsoft.graph.targetDeviceGroup",
  "id": "String (identifier)",
  "displayName": "String"
}