Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Namespace: microsoft.graph
Wichtig
Die APIs unter der /beta Version in Microsoft Graph können sich ändern. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in v1.0 verfügbar ist, verwenden Sie die Version Selektor.
Stellt die Konfiguration für das remoteDesktopSecurityConfiguration-Objekt auf dem servicePrincipal dar.
Verwenden Sie diese Konfiguration, um das Microsoft Entra ID Remotedesktop Services (RDS)-Authentifizierungsprotokoll für Microsoft Entra ID zu aktivieren, um Benutzer bei verbundenen oder hybrid verbundenen Geräten zu authentifizieren. Die Konfiguration ermöglicht außerdem einmaliges Anmelden (Single Sign-On, SSO), wenn RDP-Clients eine Verbindung mit einem in Microsoft Entra eingebundenen Gerät oder einem mit Microsoft Entra Hybrid eingebundenen Gerät herstellen, das Teil des targetDeviceGroups-Objekts ist.
Erbt von entity.
Methoden
| Methode | Rückgabetyp | Beschreibung |
|---|---|---|
| List | remoteDesktopSecurityConfiguration-Sammlung | Rufen Sie eine Liste der remoteDesktopSecurityConfiguration-Objekte und deren Eigenschaften ab. |
| Create | remoteDesktopSecurityConfiguration | Erstellen Sie ein neues remoteDesktopSecurityConfiguration-Objekt für das servicePrincipal-Objekt. |
| Get | remoteDesktopSecurityConfiguration | Lesen Sie die Eigenschaften und Beziehungen eines remoteDesktopSecurityConfiguration-Objekts für das servicePrincipal-Objekt. |
| Update | remoteDesktopSecurityConfiguration | Aktualisieren Sie die Eigenschaften eines remoteDesktopSecurityConfiguration-Objekts für das servicePrincipal-Objekt. |
| Löschen | Keine | Löschen Sie ein remoteDesktopSecurityConfiguration-Objekt für ein servicePrincipal-Objekt. |
Eigenschaften
| Eigenschaft | Typ | Beschreibung |
|---|---|---|
| id | Zeichenfolge | Eindeutiger Bezeichner für die RDS-Sicherheitskonfiguration. Geerbt von entity. |
| isRemoteDesktopProtocolEnabled | Boolean | Bestimmt, ob das Microsoft Entra ID RDS-Authentifizierungsprotokoll für RDP aktiviert ist. |
Beziehungen
| Beziehung | Typ | Beschreibung |
|---|---|---|
| approvedClientApps | approvedClientApp-Sammlung | Die Auflistung genehmigter Client-Apps, die der RDS-Konfiguration zugeordnet sind. Unterstützt $expand. |
| targetDeviceGroups | targetDeviceGroup-Sammlung | Die Sammlung der Zielgerätegruppen, die der RDS-Sicherheitskonfiguration zugeordnet sind, die für SSO aktiviert wird, wenn ein Client über RDP mit dem neuen RDS-Authentifizierungsprotokoll von Microsoft Entra ID eine Verbindung mit dem Zielgerät herstellt. |
JSON-Darstellung
Die folgende JSON-Darstellung veranschaulicht den Ressourcentyp.
{
"@odata.type": "#microsoft.graph.remoteDesktopSecurityConfiguration",
"id": "String (identifier)",
"isRemoteDesktopProtocolEnabled": "Boolean"
}