Microsoft Graph API を使用した Windows 365 クラウド PC の使用
重要
Microsoft Graph の /beta バージョンの API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 v1.0 で API を使用できるかどうかを確認するには、Version セレクターを使用します。
Windows 365 はクラウドベースのサービスであり、エンド ユーザー用に新しい種類の Windows 仮想マシン (クラウド PC) を自動的に作成します。 各クラウド PC は、専用の Windows デバイスとして個々のユーザーに割り当てられます。 Windows 365 は、Microsoft 365 の生産性、セキュリティ、およびコラボレーションの利点を提供します。
Microsoft Graph APIを使用すると、organization上のクラウド PC 情報と管理アクションにプログラムでアクセスできます。 API は、Microsoft エンドポイント マネージャーで使用できる操作と同じ操作を実行します。
重要
Microsoft Graph API for Cloud PC を使用するには、organizationのアクティブなWindows 365 ライセンスが必要です。 現在、Microsoft Graph APIはWindows 365 EnterpriseとWindows 365 Businessの両方で使用できます。
クラウド PC 用の Microsoft Graph APIの使用
Microsoft Graph を使用すると、organizationでクラウド PC をプロビジョニングおよび管理できます。 Intune API と組み合わせて使用する場合は、物理エンドポイントと共にクラウド PC を管理することもできます。
Microsoft Graph アクセス許可の使用
Microsoft Graph では、アクセス許可を介してリソースへのアクセスを制御します。 開発者は、リソースにアクセスするために必要なアクセス許可Windows 365指定する必要があります。 通常、Microsoft Entra 管理センターでアクセス許可を指定します。 詳細については、「 Microsoft Graph のアクセス許可リファレンス 」を参照し、[ クラウド PC のアクセス許可 ] セクションに移動します。
一般的なユース ケース
| ユース ケース | REST リソース | 関連項目 |
|---|---|---|
| プロビジョニング ポリシーの一覧表示、取得、作成、更新、削除、または割り当て。 | cloudPcProvisioningPolicy | プロビジョニングの概要 |
| クラウド PC の管理 (再プロビジョニング、クラウド PC の猶予期間の終了、一括再プロビジョニング、クラウド PC のサイズ変更など)。 | cloudPC | クラウド PC のライフサイクル |
| クラウド PC OS イメージの一覧表示、取得、作成、削除、ソース イメージの取得、再アップロード。 | cloudPCDeviceImage | デバイス イメージの概要 |
| ギャラリー イメージを一覧表示して取得します。 | cloudPcGalleryImage | ギャラリー イメージの概要 |
| Azure ネットワーク接続の一覧表示、取得、作成、更新、削除、AD ドメイン パスワードの更新、正常性チェックの実行。 | cloudPcOnPremisesConnection | オンプレミス ネットワーク接続の概要 |
| クラウド PC の監査イベントを一覧表示し、特定の監査イベントを取得し、監査アクティビティの種類を取得します。 | cloudPcAuditEvent | クラウド PC 監査ログを取得する |
| ユーザー設定を一覧表示、取得、作成、更新、削除、または割り当てます。 | cloudPcUserSetting | ユーザー設定の概要 |
| クラウド PC のプロビジョニング、クラウド PC イメージのアップロード、Azure ネットワーク接続の確認を使用して、Microsoft エンドポイント マネージャー管理センターで問題を警告するルールを設定します。 | alertRecord、 alertRule | アラート監視 API |
次の手順
- Microsoft Graph のWindows 365 クラウド PCの概要を確認してください。
- Microsoft Graph エクスプローラーを使用して、Windows 365クラウド PC API を試してください。