Erstellen von remoteDesktopSecurityConfiguration

Namespace: microsoft.graph

Erstellen Sie ein neues remoteDesktopSecurityConfiguration-Objekt für servicePrincipal. Verwenden Sie diese Konfiguration, um das Microsoft Entra ID RDS-Authentifizierungsprotokoll (Remotedesktopdienste) zu aktivieren, um einen Benutzer bei Microsoft Entra oderMicrosoft Entra hybrid eingebundenen Geräten zu authentifizieren.

Berechtigungen

Wählen Sie die Berechtigungen aus, die für diese API als am wenigsten privilegiert markiert sind. Verwenden Sie eine höhere Berechtigung oder Berechtigungen nur, wenn Ihre App dies erfordert. Ausführliche Informationen zu delegierten Berechtigungen und Anwendungsberechtigungen finden Sie unter Berechtigungstypen. Weitere Informationen zu diesen Berechtigungen finden Sie in der Berechtigungsreferenz.

Berechtigungstyp	Berechtigungen mit den geringsten Berechtigungen	Berechtigungen mit höheren Berechtigungen
Delegiert (Geschäfts-, Schul- oder Unikonto)	Application-RemoteDesktopConfig.ReadWrite.All	Application.ReadWrite.All, Directory.ReadWrite.All
Delegiert (persönliches Microsoft-Konto)	Nicht unterstützt	Nicht unterstützt
Anwendung	Application-RemoteDesktopConfig.ReadWrite.All	Application.ReadWrite.All, Application.ReadWrite.OwnedBy, Directory.ReadWrite.All

Wichtig

In delegierten Szenarien mit Geschäfts-, Schul- oder Unikonten muss der angemeldete Benutzer Besitzer oder Mitglied der Gruppe sein oder einer unterstützten Microsoft Entra Rolle oder einer benutzerdefinierten Rolle mit einer unterstützten Rollenberechtigung zugewiesen sein. Die folgenden Rollen mit den geringsten Berechtigungen werden für diesen Vorgang unterstützt.

• Anwendungsadministrator
• Cloudanwendungsadministrator

HTTP-Anforderung

POST /servicePrincipals/{servicePrincipalsId}/remoteDesktopSecurityConfiguration

Anforderungsheader

Name	Beschreibung
Authorization	Bearer {token}. Erforderlich. Erfahren Sie mehr über Authentifizierung und Autorisierung.
Content-Type	application/json. Erforderlich.

Anforderungstext

Geben Sie im Anforderungstext eine JSON-Darstellung des remoteDesktopSecurityConfiguration-Objekts an .

Sie können die folgenden Eigenschaften angeben, wenn Sie eine remoteDesktopSecurityConfiguration erstellen.

Eigenschaft	Typ	Beschreibung
isRemoteDesktopProtocolEnabled	Boolesch	Ob das neue Microsoft Entra ID RDS-Authentifizierungsprotokoll (Remotedesktopdienste) zur Authentifizierung eines Benutzers bei Microsoft Entra oderMicrosoft Entra hybrid eingebundenen devices.over RDP aktiviert ist oder nicht. Erforderlich.

Antwort

Wenn die Methode erfolgreich verläuft, werden der 201 Created Antwortcode und ein remoteDesktopSecurityConfiguration-Objekt im Antworttext zurückgegeben.

Beispiele

Anforderung

Das folgende Beispiel zeigt eine Anfrage.

HTTP

POST https://graph.microsoft.com/v1.0/servicePrincipals/00af5dfb-85da-4b41-a677-0c6b86dd34f8/remoteDesktopSecurityConfiguration
Content-Type: application/json

{
  "@odata.type": "#microsoft.graph.remoteDesktopSecurityConfiguration",
  "isRemoteDesktopProtocolEnabled": true
}

JavaScript

const options = {
	authProvider,
};

const client = Client.init(options);

const remoteDesktopSecurityConfiguration = {
  '@odata.type': '#microsoft.graph.remoteDesktopSecurityConfiguration',
  isRemoteDesktopProtocolEnabled: true
};

await client.api('/servicePrincipals/00af5dfb-85da-4b41-a677-0c6b86dd34f8/remoteDesktopSecurityConfiguration')
	.post(remoteDesktopSecurityConfiguration);

Einzelheiten darüber, wie Sie das SDK zu Ihrem Projekt hinzufügen und eine authProvider-Instanz erstellen, finden Sie in der SDK-Dokumentation.

Antwort

Das folgende Beispiel zeigt die Antwort.

HTTP/1.1 201 Created
Content-Type: application/json

{
  "@odata.type": "#microsoft.graph.remoteDesktopSecurityConfiguration",
  "id": "ca738153-c98a-f822-a7d1-5a6e1058462b",
  "isRemoteDesktopProtocolEnabled": true
}