remoteDesktopSecurityConfiguration を作成する
名前空間: microsoft.graph
servicePrincipal に新しい remoteDesktopSecurityConfiguration オブジェクトを作成します。 この構成を使用して、Microsoft Entra ID リモート デスクトップ サービス (RDS) 認証プロトコルを有効にして、ユーザーを認証して、参加済みまたはハイブリッド参加済みデバイスMicrosoft Entra Microsoft Entraします。
アクセス許可
この API の最小特権としてマークされているアクセス許可またはアクセス許可を選択します。 アプリで必要な場合にのみ、より高い特権のアクセス許可またはアクセス許可を使用します。 委任されたアクセス許可とアプリケーションのアクセス許可の詳細については、「 アクセス許可の種類」を参照してください。 これらのアクセス許可の詳細については、 アクセス許可のリファレンスを参照してください。
アクセス許可の種類 | 最小特権アクセス許可 | 特権の高いアクセス許可 |
---|---|---|
委任 (職場または学校のアカウント) | Application-RemoteDesktopConfig.ReadWrite.All | Application.ReadWrite.All, Directory.ReadWrite.All |
委任 (個人用 Microsoft アカウント) | サポートされていません。 | サポートされていません。 |
アプリケーション | Application-RemoteDesktopConfig.ReadWrite.All | Application.ReadWrite.OwnedBy、Application.ReadWrite.All、Directory.ReadWrite.All |
呼び出し元のユーザーには、少なくともアプリケーション管理者またはクラウド アプリケーション管理者Microsoft Entraロールを割り当てる必要があります。
HTTP 要求
POST /servicePrincipals/{servicePrincipalsId}/remoteDesktopSecurityConfiguration
要求ヘッダー
名前 | 説明 |
---|---|
Authorization | ベアラー {token}。 必須です。 認証と承認の詳細については、こちらをご覧ください。 |
Content-Type | application/json. 必須です。 |
要求本文
要求本文で、 remoteDesktopSecurityConfiguration オブジェクトの JSON 表現を指定します。
remoteDesktopSecurityConfiguration を作成するときに、次のプロパティを指定できます。
プロパティ | 型 | 説明 |
---|---|---|
isRemoteDesktopProtocolEnabled | ブール型 | 参加している Microsoft Entraユーザーを認証する新しいMicrosoft Entra IDリモート デスクトップ サービス (RDS) 認証プロトコルか、またはハイブリッド参加済みデバイスMicrosoft Entra Microsoft Entra認証プロトコルが RDP 経由で有効になっているかどうか。 必須です。 |
応答
成功した場合、このメソッドは 201 Created
応答コードと、応答本文に remoteDesktopSecurityConfiguration オブジェクトを返します。
例
要求
次の例は要求を示しています。
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
}
応答
次の例は応答を示しています。
HTTP/1.1 201 Created
Content-Type: application/json
{
"@odata.type": "#microsoft.graph.remoteDesktopSecurityConfiguration",
"id": "ca738153-c98a-f822-a7d1-5a6e1058462b",
"isRemoteDesktopProtocolEnabled": true
}
フィードバック
https://aka.ms/ContentUserFeedback」を参照してください。
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「フィードバックの送信と表示