{ "opencollection": "1.0.0", "info": { "name": "Microsoft Graph Admin Admin.admin servicePrincipals.remoteDesktopSecurityConfiguration API", "version": "1.0.0" }, "items": [ { "info": { "name": "servicePrincipals.remoteDesktopSecurityConfiguration", "type": "folder" }, "items": [ { "info": { "name": "Microsoft Graph Get remoteDesktopSecurityConfiguration", "type": "http" }, "http": { "method": "GET", "url": "https://graph.microsoft.com/v1.0/servicePrincipals/:servicePrincipal-id/remoteDesktopSecurityConfiguration", "params": [ { "name": "servicePrincipal-id", "value": "", "type": "path", "description": "The unique identifier of servicePrincipal" }, { "name": "$select", "value": "", "type": "query", "description": "Select properties to be returned" }, { "name": "$expand", "value": "", "type": "query", "description": "Expand related entities" } ] }, "docs": "Read the properties and relationships of a remoteDesktopSecurityConfiguration object on a servicePrincipal. Use this configuration to view the Microsoft Entra ID Remote Desktop Services (RDS) authentication protocol to authenticate a user to Microsoft Entra joined or Microsoft Entra hybrid joined devices. Additionally you can view any targetDeviceGroups that have been configured for SSO." }, { "info": { "name": "Microsoft Graph Update remoteDesktopSecurityConfiguration", "type": "http" }, "http": { "method": "PATCH", "url": "https://graph.microsoft.com/v1.0/servicePrincipals/:servicePrincipal-id/remoteDesktopSecurityConfiguration", "params": [ { "name": "servicePrincipal-id", "value": "", "type": "path", "description": "The unique identifier of servicePrincipal" } ], "body": { "type": "json", "data": "{}" } }, "docs": "Update the properties of a remoteDesktopSecurityConfiguration object on the servicePrincipal. Use this configuration to enable or disable the Microsoft Entra ID Remote Desktop Services (RDS) authentication protocol to authenticate a user to Microsoft Entra joined or Microsoft Entra hybrid joined devices." }, { "info": { "name": "Microsoft Graph Delete remoteDesktopSecurityConfiguration", "type": "http" }, "http": { "method": "DELETE", "url": "https://graph.microsoft.com/v1.0/servicePrincipals/:servicePrincipal-id/remoteDesktopSecurityConfiguration", "headers": [ { "name": "If-Match", "value": "" } ], "params": [ { "name": "servicePrincipal-id", "value": "", "type": "path", "description": "The unique identifier of servicePrincipal" } ] }, "docs": "Delete a remoteDesktopSecurityConfiguration object on a servicePrincipal. Removing remoteDesktopSecurityConfiguration object on the servicePrincipal disables the Microsoft Entra ID Remote Desktop Services (RDS) authentication protocol to authenticate a user to Microsoft Entra joined or Microsoft Entra hybrid joined devices, and removes any target device groups that you configured for SSO." }, { "info": { "name": "Microsoft Graph List targetDeviceGroups", "type": "http" }, "http": { "method": "GET", "url": "https://graph.microsoft.com/v1.0/servicePrincipals/:servicePrincipal-id/remoteDesktopSecurityConfiguration/targetDeviceGroups", "params": [ { "name": "servicePrincipal-id", "value": "", "type": "path", "description": "The unique identifier of servicePrincipal" }, { "name": "$top", "value": "50", "type": "query", "description": "Show only the first n items" }, { "name": "$skip", "value": "", "type": "query", "description": "Skip the first n items" }, { "name": "$search", "value": "", "type": "query", "description": "Search items by search phrases" }, { "name": "$filter", "value": "", "type": "query", "description": "Filter items by property values" }, { "name": "$count", "value": "", "type": "query", "description": "Include count of items" }, { "name": "$orderby", "value": "", "type": "query", "description": "Order items by property values" }, { "name": "$select", "value": "", "type": "query", "description": "Select properties to be returned" }, { "name": "$expand", "value": "", "type": "query", "description": "Expand related entities" } ] }, "docs": "Get a list of the targetDeviceGroup objects and their properties on the remoteDesktopSecurityConfiguration resource on the servicePrincipal. Any user authenticating using the Microsoft Entra ID Remote Desktop Services (RDS) authentication protocol to a Microsoft Entra joined or Microsoft Entra hybrid joined device that belongs to the targetDeviceGroup will get SSO." }, { "info": { "name": "Microsoft Graph Create targetDeviceGroup", "type": "http" }, "http": { "method": "POST", "url": "https://graph.microsoft.com/v1.0/servicePrincipals/:servicePrincipal-id/remoteDesktopSecurityConfiguration/targetDeviceGroups", "params": [ { "name": "servicePrincipal-id", "value": "", "type": "path", "description": "The unique identifier of servicePrincipal" } ], "body": { "type": "json", "data": "{}" } }, "docs": "Create a new targetDeviceGroup object for the remoteDesktopSecurityConfiguration object on the servicePrincipal. You can configure a maximum of 10 target device groups for the remoteDesktopSecurityConfiguraiton object on the servicePrincipal." }, { "info": { "name": "Microsoft Graph Get targetDeviceGroup", "type": "http" }, "http": { "method": "GET", "url": "https://graph.microsoft.com/v1.0/servicePrincipals/:servicePrincipal-id/remoteDesktopSecurityConfiguration/targetDeviceGroups/:targetDeviceGroup-id", "params": [ { "name": "servicePrincipal-id", "value": "", "type": "path", "description": "The unique identifier of servicePrincipal" }, { "name": "targetDeviceGroup-id", "value": "", "type": "path", "description": "The unique identifier of targetDeviceGroup" }, { "name": "$select", "value": "", "type": "query", "description": "Select properties to be returned" }, { "name": "$expand", "value": "", "type": "query", "description": "Expand related entities" } ] }, "docs": "Read the properties and relationships of a targetDeviceGroup object for the remoteDesktopSecurityConfiguration object on the servicePrincipal." }, { "info": { "name": "Microsoft Graph Update targetDeviceGroup", "type": "http" }, "http": { "method": "PATCH", "url": "https://graph.microsoft.com/v1.0/servicePrincipals/:servicePrincipal-id/remoteDesktopSecurityConfiguration/targetDeviceGroups/:targetDeviceGroup-id", "params": [ { "name": "servicePrincipal-id", "value": "", "type": "path", "description": "The unique identifier of servicePrincipal" }, { "name": "targetDeviceGroup-id", "value": "", "type": "path", "description": "The unique identifier of targetDeviceGroup" } ], "body": { "type": "json", "data": "{}" } }, "docs": "Update the properties of a targetDeviceGroup object for remoteDesktopSecurityConfiguration object on the servicePrincipal. You can configure a maximum of 10 target device groups for the remoteDesktopSecurityConfiguraiton object on the servicePrincipal." }, { "info": { "name": "Microsoft Graph Delete targetDeviceGroup", "type": "http" }, "http": { "method": "DELETE", "url": "https://graph.microsoft.com/v1.0/servicePrincipals/:servicePrincipal-id/remoteDesktopSecurityConfiguration/targetDeviceGroups/:targetDeviceGroup-id", "headers": [ { "name": "If-Match", "value": "" } ], "params": [ { "name": "servicePrincipal-id", "value": "", "type": "path", "description": "The unique identifier of servicePrincipal" }, { "name": "targetDeviceGroup-id", "value": "", "type": "path", "description": "The unique identifier of targetDeviceGroup" } ] }, "docs": "Delete a targetDeviceGroup object for the remoteDesktopSecurityConfiguration object on the servicePrincipal. Any user authenticating using the Microsoft Entra ID Remote Desktop Services (RDS) authentication protocol to a Microsoft Entra joined or Microsoft Entra hybrid joined device that's in the removed targetDeviceGroup doesn't get SSO prompts." }, { "info": { "name": "Microsoft Graph Get the number of the resource", "type": "http" }, "http": { "method": "GET", "url": "https://graph.microsoft.com/v1.0/servicePrincipals/:servicePrincipal-id/remoteDesktopSecurityConfiguration/targetDeviceGroups/$count", "params": [ { "name": "servicePrincipal-id", "value": "", "type": "path", "description": "The unique identifier of servicePrincipal" }, { "name": "$search", "value": "", "type": "query", "description": "Search items by search phrases" }, { "name": "$filter", "value": "", "type": "query", "description": "Filter items by property values" } ] }, "docs": "Microsoft Graph Get the number of the resource" } ] } ], "bundled": true }