Windows 365（預覽版）

Windows 365 是一項雲端服務，能自動為終端使用者建立一種新型的 Windows 虛擬機器（雲端 PC）。 每台雲端電腦會被指派給個別使用者，作為專用的 Windows 裝置。 Windows 365 提供 Microsoft 365 的生產力、安全性與協作優勢。

此連接器適用於以下產品和區域：

服務 Class Regions
Copilot Studio 進階 除以下部分外，所有Power Automate區域：
     - 美國政府 （GCC）
     - 美國政府（海灣合作委員會高中）
     - 由 21Vianet 營運的中國雲
     - 美國國防部 （DoD）
邏輯應用程式 標準 所有 Logic Apps 區域， 但下列區域除外：
     - Azure Government regions
     - Azure中國地區
     - 美國國防部 （DoD）
Power Apps 進階 除以下部分外，所有Power Apps區域
     - 美國政府 （GCC）
     - 美國政府（海灣合作委員會高中）
     - 由 21Vianet 營運的中國雲
     - 美國國防部 （DoD）
Power Automate（自動化服務） 進階 除以下部分外，所有Power Automate區域：
     - 美國政府 （GCC）
     - 美國政府（海灣合作委員會高中）
     - 由 21Vianet 營運的中國雲
     - 美國國防部 （DoD）
連絡人​​
名稱 Microsoft
URL https://powerautomate.microsoft.com/en-us/support/
連接器中繼資料
Publisher Microsoft
網站 https://www.microsoft.com/en-us/windows-365
隱私策略 https://privacy.microsoft.com/en-us/privacystatement
類別 IT運營;生產力
服務 類別 區域
Copilot Studio 進階 所有Power Automate區域
邏輯應用程式 進階 所有 Logic Apps 區域
Power Apps 進階 所有Power Apps區域
Power Automate（自動化服務） 進階 所有Power Automate區域
連絡人
名稱 Windows 365
URL https://learn.microsoft.com/en-us/connectors/windows365
Email W365powerplatform@microsoft.com

已知問題與限制

Windows 365 連接器目前處於公開預覽階段。

在連接器正式發行前，Microsoft 想要確認該連接器是穩定的。 直到那之前，連接器都處於預覽版狀態。 預覽版是「按原貌」提供，「不保證無瑕疵」且「僅可於已發行處取得」。 這些版本已從服務等級協定 (SLAs) 中排除，但是以預覽形式推出，讓您可以搶先體驗並提供意見反應。 深入了解預覽功能和啟用這些功能的方法。 客戶支援可能不涵蓋預覽。 隨時可能會無預告中止或中斷，而且可能無法進入正式發行階段。

我們鼓勵您試用預覽版連接器並提供意見反應。 這將協助我們穩定並改善連接器。 您可以利用產品論壇來分享問題和意見反應。 預覽功能 (包括連接器) 可能無法使用 Microsoft 支援服務，但是我們會試著盡最大努力提供支援。

欲了解更多，請參閱預覽版連接器 常見問題集。

一般限制

  1. 能力與限制與底層圖形 API一致。
  2. 當需要呼叫 Graph beta 端點時，請使用 HTTP 請求動作。

動作：

List Cloud PC

行動編號： ListCloudPCs

這個動作可以讓你列出雲端電腦。

參數

名稱 為必填項目 類型 Description
$select 否 字串 $select 讓你選擇從 Graph 回傳哪些屬性。
$filter 否 字串 $filter 允許你從 Graph 取得集合的子集。

傳回

名稱 類型 Description
aadDeviceID 繩子 Microsoft Entra 雲端 PC 裝置 ID，也稱為 Azure Active Directory（Azure AD）裝置 ID，由 32 個字元的 GUID 格式組成。 在一台與 Microsoft Entra ID 連接的虛擬機上產生。 唯讀。
diskEncryptionState 繩子 顯示磁碟加密狀態。
顯示名稱 繩子 Cloud PC 的顯示名稱。 長度上限是 64 個字元。 唯讀。
寬限期結束日期時間 DateTimeOffset 寬限期結束並進行重新配置或取消的日期和時間。 只有在狀態為 inGracePeriod 時才需要。 時間戳以 ISO 8601 格式及協調世界時（UTC）顯示。 例如，2014 年 1 月 1 日的午夜 UTC 時間是 2014-01-01T00：00：00Z。
id 繩子 面向客戶的雲端電腦實體唯一識別碼，由 32 個字元組成，採用 GUID 格式。 唯讀。
imageDisplayName 繩子 雲端電腦所使用的作業系統映像名稱。 最大長度為50字元。 此性質僅允許使用字母（A-Z、a-z）、數字（0-9）及特殊字元（-，_，.）。 房產價值不能以下劃線開始或結束。 唯讀。
最後修改日期時間 DateTimeOffset 雲端電腦最後修改的日期與時間。 時間戳記類型以 ISO 8601 格式表示日期與時間資訊，且始終以 UTC 為單位。 例如，2014 年 1 月 1 日的午夜 UTC 時間是 2014-01-01T00：00：00Z。
managedDeviceId 繩子 Intune 註冊的雲端電腦裝置 ID，包含 32 個字元，採用 GUID 格式。 Windows 365 商務版雲端電腦的managedDeviceId屬性永遠是空的，因為Windows 365 商務版雲端電腦並未被Windows 365自動註冊為 Intune。 唯讀。
managedDeviceName 繩子 雲端電腦的 Intune 註冊裝置名稱。 Windows 365 商務版 雲端電腦的 managedDeviceName 屬性總是空的，因為Windows 365 商務版雲端電腦並未被 Windows 365 自動註冊為 Intune。 唯讀。
onPremisesConnectionName 繩子 雲端電腦配置期間的本地連線。 唯讀。
provisioningPolicyID 繩子 雲端電腦的配置政策 ID，由 32 個字元組成，採用 GUID 格式。 政策定義使用者想要建立的雲端電腦類型。 唯讀。
provisioningPolicyName 繩子 在雲端 PC 配置期間適用的配置政策。 最大長度為120字元。 唯讀。
provisioningType 繩子 顯示配置類型。
服務計劃ID 繩子 雲端 PC 的服務方案 ID 由 32 個字元組成，格式為 GUID。 欲了解更多服務計畫資訊，請參閱 產品名稱及授權服務計畫識別碼。 唯讀。
servicePlanName 繩子 服務方案名稱，指的是面向客戶的雲端 PC 實體。 唯讀。
服務計畫類型 繩子 顯示計畫類型。
userPrincipalName 繩子 指派給雲端電腦的使用者主體名稱（UPN）。 最大長度為113個字元。 欲了解更多使用者名稱政策資訊，請參閱 Microsoft Entra ID 中的密碼政策與帳號限制。 唯讀。

取得配置政策

行動編號： GetProvisioningPoliciesV1

此操作允許您回傳有關配置政策的資訊。

參數

名稱 為必填項目 類型 Description
$select 否 繩子 $select 讓你選擇從 Graph 回傳哪些屬性。
$filter 否 繩子 $filter 允許你從 Graph 取得集合的子集。
$expand 否 繩子 $expand 讓你能從 Graph 回傳相關資源。

傳回

使用帶有賦值值的$expand，可以看到以下回傳的值：

名稱 類型 Description
cloudPCNamingTemplate 繩子 用來命名使用此政策配置的雲端 PC 的範本。 模板可包含自訂文字與替換標記，包括 %USERNAME：x% 和 %RAND：x%，分別代表使用者姓名與隨機生成的數字。 例如，CPC-%USERNAME：4%-%RAND：5% 表示雲端電腦名稱以 CPC- 開頭，接著是四個字元的用戶名、一個 - 字元，最後是五個隨機字元。 模板產生的文字總長度不得超過 15 個字元。
description 繩子 配置政策描述。
顯示名稱 繩子 配置政策的顯示名稱。
domainJoinConfiguration cloudPcDomainJoinConfiguration collection 指定一個依優先順序排列的清單，說明雲端 PC 如何加入 Microsoft Entra ID（Azure AD）。
enableSingleSignOn 布林值 如果配置好的雲端電腦能透過單一登入存取，那就成立。 錯誤表示已配置的雲端電腦不支援此功能。 預設值為 false。 Windows 365 使用者可以使用單一登入功能，透過無密碼選項（例如 FIDO 金鑰）驗證 Microsoft Entra ID 以存取雲端電腦
id 繩子 與配置政策相關的唯一識別碼。 這個 ID 會在建立新的配置政策時自動填充。 唯讀。
imageDisplayName 繩子 用於配置的作業系統映像檔的顯示名稱。 例如，Windows 11 預覽版 + Microsoft 365 Apps 23H2 23H2。
imageID 繩子 代表用於配置新雲端 PC 的作業系統映像的唯一識別碼。 圖庫類型的圖片格式為：{publisherName_offerName_skuName}。 每個參數的支援值如下：
  • 出版者：Microsoftwindowsdesktop
  • Offer： Windows-ent-CPC
  • SKU：21h1-ENT-CPC-M365,21h1-ENT-CPC-OS，20H2-ENT-CPC-M365,20H2-ENT-CPC-OS，20H1-ENT-CPC-M365,20H1-ENT-CPC-OS，19H2-ENT-CPC-M365，以及19H2-ENT-CPC-OS
image類型 cloudPcProvisioningPolicyImageType 用於雲端電腦配置的作業系統映像（自訂或圖庫）類型。 可能的數值有：畫廊、自訂。 預設值為畫廊。

取得設定政策

行動編號： GetAProvisioningPolicyV1

此操作可讓您取得特定配置政策的詳細資訊。

參數

名稱 為必填項目 類型 Description
配置政策識別碼 Yes 繩子 配置政策的識別碼。 必須包含在內。
$select 否 繩子 $select 讓你選擇從 Graph 回傳哪些屬性。
$filter 否 繩子 $filter 允許你從 Graph 取得集合的子集。

傳回

此作業會輸出隨機的結果。

建立配置政策

行動編號： CreateAProvisioningPolicyV1

此操作允許您建立配置政策。

參數

名稱 為必填項目 類型 Description
Name Yes 繩子 在雲端 PC 配置期間適用的配置政策。 最大長度為120字元
說明 Yes 繩子 配置政策描述。
網域連接配置 Yes
影像識別碼 Yes 繩子 這就是你想用來配置雲端電腦的映像 ID。
影像顯示名稱 Yes 繩子 雲端電腦所使用的作業系統映像名稱。 最大長度為50字元。 此性質僅允許使用字母（A-Z、a-z）、數字（0-9）及特殊字元（-，_，.）。 房產價值不能以下劃線開始或結束。
影像類型 Yes 繩子 自訂或畫廊。
配置類型 Yes 繩子 無論是共享還是奉獻。
Windows 設定/地點 Yes 繩子 提供你想使用的語言或地點。 Windows 365 提供超過 30 種此類語言/區域配對。

你也可以在 Graph 的進階參數下新增其他欄位。

傳回

此作業會輸出隨機的結果。

指派一個配置政策給群組

行動編號： AssignAProvisioningPolicyToAGroupV1

此操作允許您將群組指派至配置政策。

參數

名稱 為必填項目 類型 Description
配置政策識別碼 Yes 繩子 這是你想要指派群組的配置政策 ID。
分配- ID
分配 – 目標群組識別碼 Yes 繩子 來自 Entra ID 的使用者群組。

傳回

此作業會輸出隨機的結果。

更新配置政策

行動編號： 更新AProvisioningPolicyV1

此操作允許你更新配置政策。

參數

名稱 為必填項目 類型 Description
配置政策識別碼 Yes 繩子 這是你想更新的配置政策的 ID。
說明 否 繩子 這就是配置政策描述將更新到的狀態。

你也可以在 Graph 的進階參數下新增其他欄位。

傳回

此作業會輸出隨機的結果。

取得設定政策

行動編號： GetAProvisioningPolicyV1

此操作可讓你取得配置政策的詳細資訊。

參數

名稱 為必填項目 類型 Description
配置政策識別碼 Yes 繩子 雲端電腦的配置政策 ID，由 32 個字元組成，採用 GUID 格式。 政策定義使用者想要建立的雲端電腦類型。
$select 否 繩子 $select 讓你選擇從 Graph 回傳哪些屬性。
$expand 否 繩子 $expand 讓你能從 Graph 回傳相關資源。

你也可以在 Graph 的進階參數下新增其他欄位。

傳回

此作業會輸出隨機的結果。

啟動遠端行動

行動編號： 遠距行動

這個動作讓你可以在雲端電腦上開始遠端操作。

參數

名稱 為必填項目 類型 Description
雲端 PC ID Yes 繩子 這讓你能遠端指定想鎖定的 Cloud PC ID。
遙控行動 Yes 繩子 這讓你可以選擇何時在雲端電腦上進行遠端操作。
遠端動作 – 快照識別碼 否 繩子 如果你選擇還原雲端電腦，也必須提供快照 ID。
遠端動作 – 顯示名稱 否 繩子 如果你選擇重新命名雲端電腦，也必須提供顯示名稱。

傳回

若成功，則回傳 204 無內容回應碼。

發送 Microsoft Graph HTTP 請求

行動編號： HttpRequest

此操作允許您直接呼叫 Graph 並自訂通話內容。

參數

名稱 為必填項目 類型 Description
URI Yes 繩子 這讓你可以指定要呼叫哪個 URI，例如： https://graph.microsoft.com/v1.0/deviceManagement/virtualEndpoint/auditEvents
方法 Yes 繩子 這讓你可以定義呼叫方法。

你也可以在進階參數下新增其他欄位（標頭、正文等）。

傳回

此作業會輸出隨機的結果。

觸發器：

所有情境都包含在一個觸發器中，該觸發器可在觸發器本體中選擇。

當雲端電腦上的遠端動作被觸發時 允許你在遠端動作觸發時觸發流程。
當雲端電腦上的遠端動作完成時 允許你在雲端電腦遠端操作完成時觸發流程。
當配置政策更新時 允許你在更新配置政策時觸發流程
當建立新的配置政策時 允許你在建立配置政策時啟動流程。
當雲端電腦建立時 這個觸發器允許你在建立雲端電腦時啟動流程。

當配置政策或雲端電腦更新時

行動編號： 網路鉤

當配置政策或雲端電腦更新時，此觸發器會觸發。

參數

名稱 為必填項目 類型 Description
案例 Yes 下拉式選單 你可以從以下支援的情境中選擇：
  1. 當雲端電腦建立時
  2. 當建立新的配置政策時
  3. 當配置政策更新時
  4. 當雲端電腦上的遠端動作完成時
  5. 當雲端電腦上的遠端動作被觸發時

傳回

此作業會輸出隨機的結果。

9/15 文件更新：

  1. 在「當配置政策或雲端電腦更新（棄用）」觸發條件後，加上「棄用」
  2. 在其章節下方補充：「此觸發器仍可用於現有流程，但未來不會有新的更新。 我們建議使用新的觸發器。」
  3. 新增文件以處理新的觸發條件，具體如下：

當建立新的配置政策時

行動編號： WebhookProvisioningPolicyCreated

參數：

名稱 為必填項目 類型 Description
過濾配置政策名稱 否 繩子 這樣你就可以根據政策名稱模式設定篩選器，根據流程來觸發流程。 舉例來說，如果你的組織使用配置政策名稱範本，而你想根據它觸發流程，你可以在這裡指定範本。
過濾配置政策識別碼 否 繩子 這讓你可以選擇一個或多個特定的政策 ID，來觸發此流程。
過濾器配置類型 否 繩子 這讓你可以選擇單一或多種特定的配置類型來觸發此流程。 例如，你可能想只觸發 Windows 365 企業版 的配置政策流程。

傳回

此作業會輸出隨機的結果。

當雲端電腦建立時

行動編號： WebhookCloudPcProvisioned

這個觸發器允許你根據雲端角色的建立時間觸發流程。

參數

名稱 為必填項目 類型 Description
過濾器配置類型 否 繩子 這讓你可以指定哪個 Windows 365 版本會觸發這個流程。 你可以在篩選器中以「或」關係指定多種類型。

傳回

此作業會輸出隨機的結果。

當配置政策更新時

行動編號： WebhookProvisioningPolicy已更新

這個觸發器允許你根據配置政策更新的時間來觸發流程。

參數

名稱 為必填項目 類型 Description
過濾配置政策名稱 否 繩子 這讓你可以選擇一個或多個特定保單名稱來觸發此流程。
過濾配置政策識別碼 否 繩子 這讓你可以選擇一個或多個特定的政策 ID，來觸發此流程。
過濾器配置類型 否 繩子 這讓你可以選擇單一或多種特定的配置類型來觸發此流程。 例如，你可能想只觸發 Windows 365 企業版 的配置政策流程。

傳回

名稱 類型 Description
provisioningPolicyID 繩子 更新的配置政策 ID。 包含 32 個字元，採用 GUID 格式。
provisioningPolicyName 繩子 更新的配置政策名稱。

當雲端電腦上的遠端動作被觸發時

行動編號： WebhookCloudPcRemoteActionTriggered

這個觸發器允許你根據雲端電腦上的遠端動作觸發時間觸發流程。

參數

名稱 為必填項目 類型 Description
過濾器配置類型 否 繩子 這讓你可以選擇單一或多種特定的配置類型來觸發此流程。 例如，你可能想針對與 Windows 365 企業版 配置政策相關的雲端電腦觸發遠端動作流程。

傳回

名稱 類型 Description
CloudPcID 繩子 雲端電腦識別碼的遠端操作完成。
provisioningType 繩子 配置類型顯示的是 Windows 365 雲端 PC 版本。
actionType 繩子 遠端操作的類型，例如重新啟動。

當雲端電腦上的遠端動作完成時

行動編號： Webhook.CloudPC.Action已完成

這個觸發器允許你根據雲端電腦上的遠端動作完成時間觸發流程。

參數

名稱 為必填項目 類型 Description
過濾器配置類型 否 繩子 這讓你可以選擇單一或多種特定的配置類型來觸發此流程。 例如，你可能想針對與 Windows 365 企業版 配置政策相關的雲端電腦觸發遠端動作流程。

傳回

名稱 類型 Description
CloudPcID 繩子 雲端電腦識別碼的遠端操作完成。
provisioningType 繩子 配置類型顯示的是 Windows 365 雲端 PC 版本。
actionType 繩子 遠端操作的類型，例如重新啟動。

節流限制

名稱 呼叫 續約期間
每個連線的 API 呼叫 100 60 秒

動作

List Cloud PC

CloudPC 列表
刪除配置政策

刪除一個配置政策。
取得設定政策

會獲得特定的配置政策。
取得配置政策

會拿到一份配置政策清單。
啟動遠端行動

在雲端電腦上啟動遠端操作。
建立配置政策

建立配置政策。
指派一個配置政策給群組

為群組指派一個配置政策。
更新配置政策

更新配置政策。
發送 Microsoft Graph HTTP 請求（預覽版）

建構一個 Microsoft Graph REST API 請求
買一台雲端電腦

拿到雲端電腦

List Cloud PC

作業識別碼：
ListCloudPCs

CloudPC 列表

參數

名稱 機碼 必要 類型 Description
選擇
 $select string

選擇要回傳的屬性。
Filter
 $filter string

例如 provisioningPolicyName 等式為 'XXX' 與 userPrincipalName-等式為 'XXX'

傳回

名稱 路徑 類型 Description
ID
 id string

面向客戶的雲端電腦實體唯一識別碼，由 32 個字元組成，採用 GUID 格式。
Entra 裝置 ID
 aadDeviceId string

Microsoft Entra 雲端 PC 裝置 ID，也稱為 Azure Active Directory（Azure AD）裝置 ID，由 32 個字元的 GUID 格式組成。 在一台與 Microsoft Entra ID 連接的虛擬機上產生。 唯讀。
顯示名稱
 displayName string

Cloud PC 的顯示名稱。 長度上限是 64 個字元。 唯讀。
影像顯示名稱
 imageDisplayName string

雲端電腦所使用的作業系統映像名稱。 最大長度為50字元。
配置政策識別碼
 provisioningPolicyId string

雲端電腦的配置政策 ID，由 32 個字元組成，採用 GUID 格式。 政策定義使用者想要建立的雲端電腦類型。
配置政策名稱
 provisioningPolicyName string

在雲端 PC 配置期間適用的配置政策。
本地連線名稱
 onPremisesConnectionName string

在雲端 PC 配置期間，適用的 Azure 網路連線。
服務方案ID
 servicePlanId string

雲端 PC 的服務方案 ID 由 32 個字元組成，格式為 GUID。
服務計畫名稱
 servicePlanName string

服務方案名稱，指的是面向客戶的雲端電腦實體。
狀態
 status string

狀態
使用者主體名稱
 userPrincipalName string

指派給雲端電腦的使用者主體名稱（UPN）。
最後修改日期/時間
 lastModifiedDateTime string

雲端電腦最後修改的日期與時間。 時間戳記類型以 ISO 8601 格式表示日期與時間資訊，且始終以 UTC 為單位。
受管理裝置識別碼
 managedDeviceId string

Intune 註冊的雲端電腦裝置 ID，包含 32 個字元，採用 GUID 格式。
受管理裝置名稱
 managedDeviceName string

雲端電腦的 Intune 註冊裝置名稱。
寬限期結束日期/時間
 gracePeriodEndDateTime string

寬限期結束並進行重新配置或取消的日期和時間。
磁碟加密狀態
 diskEncryptionState string

磁碟加密狀態
配置類型
 provisioningType string

使用此政策配置雲端電腦時應使用的授權類型。
分配顯示名稱
 allotmentDisplayName string

分配顯示名稱
狀態詳情
 statusDetail string

狀態詳情
啟用單一登入
 connectionSetting.enableSingleSignOn boolean

說明配置政策是否啟用了雲端電腦的單點登入（SSO）。
partnerAgentInstallResults
 partnerAgentInstallResults array of string

partnerAgentInstallResults

刪除配置政策

作業識別碼：
DeleteAProvisioningPolicyV1

刪除一個配置政策。

參數

名稱 機碼 必要 類型 Description
配置政策識別碼
 id True string

識別碼

取得設定政策

作業識別碼：
GetAProvisioningPolicyV1

會獲得特定的配置政策。

參數

名稱 機碼 必要 類型 Description
配置政策識別碼
 id True string

識別碼
選擇
 $select string

若未指定預設屬性，則回傳預設屬性;第一個選項會回傳所有屬性。
展開
 $expand string

內嵌展開相關實體。

傳回

名稱 路徑 類型 Description
指派
 assignments array of object
items
 assignments object
Description
 description string

配置政策描述。
顯示名稱
 displayName string

配置政策顯示名稱。
網域連接配置
 domainJoinConfigurations array of object

依優先順序列出雲端電腦如何加入 Microsoft Entra ID。
onPremisesConnectionId
 domainJoinConfigurations.onPremisesConnectionId string

onPremisesConnectionId
型別
 domainJoinConfigurations.type string

型別
管理型別
 microsoftManagedDesktop.managedType string

管理型別
個人資料
 microsoftManagedDesktop.profile string

個人資料
autopatchGroupID
 autopatch.autopatchGroupId string

autopatchGroupID
裝置準備設定ID
 autopilotConfiguration.devicePreparationProfileId string

裝置準備設定ID
applicationTimeoutInMinutes（應用時間出分鐘）
 autopilotConfiguration.applicationTimeoutInMinutes integer

applicationTimeoutInMinutes（應用時間出分鐘）
onFailureDeviceAccessDenied
 autopilotConfiguration.onFailureDeviceAccessDenied boolean

onFailureDeviceAccessDenied
啟用單一登入
 enableSingleSignOn boolean

說明配置政策是否啟用了雲端電腦的單點登入（SSO）。
身份識別碼
 id string

識別碼
影像顯示名稱
 imageDisplayName string

你正在配置的作業系統映像檔的顯示名稱。
影像標識碼
 imageId string

你想在雲端電腦上配置的作業系統映像的 ID。
影像類型
 imageType string

你想在雲端電腦上配置哪種作業系統映像（自訂或圖庫）類型。
地區設定
 windowsSetting.locale string

地區設定
managedBy
 managedBy string

managedBy
配置類型
 provisioningType string

規定使用此政策配置雲端電腦時所使用的授權類型。

取得配置政策

作業識別碼：
GetProvisioningPoliciesV1

會拿到一份配置政策清單。

參數

名稱 機碼 必要 類型 Description
選擇
 $select string

若未指定預設屬性，則回傳預設屬性;第一個選項會回傳所有屬性。
Filter
 $filter string

依照物業價值篩選項目。
展開
 $expand string

內嵌展開相關實體。

傳回

名稱 路徑 類型 Description
value
 value array of object

value
指派
 value.assignments array of object
items
 value.assignments object
Description
 value.description string

配置政策描述。
顯示名稱
 value.displayName string

配置政策顯示名稱。
網域連接配置
 value.domainJoinConfigurations array of object

依優先順序列出雲端電腦如何加入 Microsoft Entra ID。
onPremisesConnectionId
 value.domainJoinConfigurations.onPremisesConnectionId string

onPremisesConnectionId
型別
 value.domainJoinConfigurations.type string

型別
管理型別
 value.microsoftManagedDesktop.managedType string

管理型別
個人資料
 value.microsoftManagedDesktop.profile string

個人資料
autopatchGroupID
 value.autopatch.autopatchGroupId string

autopatchGroupID
裝置準備設定ID
 value.autopilotConfiguration.devicePreparationProfileId string

裝置準備設定ID
applicationTimeoutInMinutes（應用時間出分鐘）
 value.autopilotConfiguration.applicationTimeoutInMinutes integer

applicationTimeoutInMinutes（應用時間出分鐘）
onFailureDeviceAccessDenied
 value.autopilotConfiguration.onFailureDeviceAccessDenied boolean

onFailureDeviceAccessDenied
啟用單一登入
 value.enableSingleSignOn boolean

說明配置政策是否啟用了雲端電腦的單點登入（SSO）。
身份識別碼
 value.id string

識別碼
影像顯示名稱
 value.imageDisplayName string

你正在配置的作業系統映像檔的顯示名稱。
影像標識碼
 value.imageId string

你想在雲端電腦上配置的作業系統映像的 ID。
影像類型
 value.imageType string

你想在雲端電腦上配置哪種作業系統映像（自訂或圖庫）類型。
地區設定
 value.windowsSetting.locale string

地區設定
managedBy
 value.managedBy string

managedBy
配置類型
 value.provisioningType string

規定使用此政策配置雲端電腦時所使用的授權類型。

啟動遠端行動

作業識別碼：
RemoteActions

在雲端電腦上啟動遠端操作。

參數

名稱 機碼 必要 類型 Description
雲端 PC ID
 cloudPcId True string

雲端電腦的唯一識別碼。
遙控行動
 remoteAction True string

遠端操作在雲端電腦上執行。
雲端 PC 快照識別碼
 cloudPcSnapshotId string

修復所需
顯示名稱
 displayName string

更名所需

建立配置政策

作業識別碼：
CreateAProvisioningPolicyV1

建立配置政策。

參數

名稱 機碼 必要 類型 Description
名稱
 displayName True string

顯示名稱
Description
 description True string

說明
domainJoinType
 domainJoinType string
型別
 type string
regionName （區域名稱）
 regionName string
onPremisesConnectionId
 onPremisesConnectionId string
regionGroup
 regionGroup string
其他領域
 otherFields object

其他欄位
啟用單一登入
 enableSingleSignOn boolean

enableSingleSignOn
影像標識碼
 imageId True string

imageId
影像顯示名稱
 imageDisplayName True string

imageDisplayName
影像類型
 imageType True string

影像類型
配置類型
 provisioningType True string

provisioningType
Locale
 locale True string

地區設定
管理型別
 managedType string

管理型別
Profile
 profile string

個人資料

傳回

名稱 路徑 類型 Description
識別碼
 id string

識別碼
顯示名稱
 displayName string

配置政策顯示名稱。
Description
 description string

配置政策描述。
影像標識碼
 imageId string

你想在雲端電腦上配置的作業系統映像的 ID。
影像顯示名稱
 imageDisplayName string

你正在配置的作業系統映像檔的顯示名稱。
影像類型
 imageType string

你想在雲端電腦上配置哪種作業系統映像（自訂或圖庫）類型。
啟用單一登入
 enableSingleSignOn boolean

說明配置政策是否啟用了雲端電腦的單點登入（SSO）。
雲端 PC 命名範本
 cloudPcNamingTemplate string

用來命名使用此政策配置的雲端 PC 的範本。
配置類型
 provisioningType string

規定使用此政策配置雲端電腦時所使用的授權類型。
managedBy
 managedBy string

managedBy
scopeIds
 scopeIds array of

scopeIds
自動修補設定
 autopatch string

顯示使用此配置政策的雲端電腦 Windows 自動修補設定。
自動駕駛設定
 autopilotConfiguration string

自動駕駛設定
domainJoinConfigurations
 domainJoinConfigurations array of object

domainJoinConfigurations
domainJoinType
 domainJoinConfigurations.domainJoinType string

domainJoinType
型別
 domainJoinConfigurations.type string

型別
regionName （區域名稱）
 domainJoinConfigurations.regionName string

regionName （區域名稱）
onPremisesConnectionId
 domainJoinConfigurations.onPremisesConnectionId string

onPremisesConnectionId
regionGroup
 domainJoinConfigurations.regionGroup string

regionGroup
管理型別
 microsoftManagedDesktop.managedType string

管理型別
型別
 microsoftManagedDesktop.type string

型別
個人資料
 microsoftManagedDesktop.profile string

個人資料
地區設定
 windowsSetting.locale string

地區設定
語言
 windowsSettings.language string

語言

指派一個配置政策給群組

作業識別碼：
AssignAProvisioningPolicyToAGroupV1

為群組指派一個配置政策。

參數

名稱 機碼 必要 類型 Description
配置政策識別碼
 id True string

識別碼
配置政策識別碼
 id string

這是你想要指派群組的配置政策 ID
群組識別碼
 groupId True string

groupId
servicePlanId
 servicePlanId string

目標服務計畫識別碼

更新配置政策

作業識別碼：
UpdateAProvisioningPolicyV1

更新配置政策。

參數

名稱 機碼 必要 類型 Description
配置政策識別碼
 id True string

識別碼
群組識別碼
 autopatchGroupId string

autopatchGroupID
裝置準備設定檔 ID
 devicePreparationProfileId string

裝置準備設定ID
申請逾時：幾分鐘
 applicationTimeoutInMinutes integer

applicationTimeoutInMinutes（應用時間出分鐘）
故障時裝置存取被拒絕
 onFailureDeviceAccessDenied boolean

onFailureDeviceAccessDenied
Description
 description string

說明
顯示名稱
 displayName string

顯示名稱
網域連接類型
 domainJoinType string

domainJoinType
本地連線識別碼
 onPremisesConnectionId string

onPremisesConnectionId
區域群組
 regionGroup string

regionGroup
區域名稱
 regionName string

regionName （區域名稱）
類型
 type string

型別
啟用單一登入
 enableSingleSignOn boolean

enableSingleSignOn
影像顯示名稱
 imageDisplayName string

imageDisplayName
影像標識碼
 imageId string

imageId
影像類型
 imageType string

影像類型
管理型態
 managedType string

管理型別
Profile
 profile string

個人資料
Locale
 locale string

地區設定
其他領域
 otherFields object

其他欄位

發送 Microsoft Graph HTTP 請求（預覽版）

作業識別碼：
HttpRequest

建構一個 Microsoft Graph REST API 請求

參數

名稱 機碼 必要 類型 Description
URI
 Uri True string

完整或相對 URI。 範例：https://graph.microsoft.com/{version}/{resource}
方法
 Method True string

HTTP 方法 （預設值為 GET）
身體
 Body binary

請求本文內容
內容-類型
 ContentType string

內文的內容類型標頭 （預設值為 application/json）
自訂標頭1
 CustomHeader1 string

自訂標頭 1. 以格式指定：header-name：header-value
自訂標頭2
 CustomHeader2 string

自訂標頭 2. 以格式指定：header-name：header-value
自訂標頭3
 CustomHeader3 string

自訂標題 3. 以格式指定：header-name：header-value
自訂標頭4
 CustomHeader4 string

自訂標題 4. 以格式指定：header-name：header-value
自訂標頭5
 CustomHeader5 string

自訂標題 5. 以格式指定：header-name：header-value

傳回

response
ObjectWithoutType

買一台雲端電腦

作業識別碼：
GetACloudPCObject

拿到雲端電腦

參數

名稱 機碼 必要 類型 Description
雲端 PC ID
 cloudPcId True string

雲端電腦的唯一識別碼。
選擇
 $select string

選擇要回傳的屬性。

傳回

名稱 路徑 類型 Description
ID
 id string

面向客戶的雲端電腦實體唯一識別碼，由 32 個字元組成，採用 GUID 格式。
Entra 裝置 ID
 aadDeviceId string

Microsoft Entra 雲端 PC 裝置 ID，也稱為 Azure Active Directory（Azure AD）裝置 ID，由 32 個字元的 GUID 格式組成。 在一台與 Microsoft Entra ID 連接的虛擬機上產生。 唯讀。
顯示名稱
 displayName string

Cloud PC 的顯示名稱。 長度上限是 64 個字元。 唯讀。
影像顯示名稱
 imageDisplayName string

雲端電腦所使用的作業系統映像名稱。 最大長度為50字元。
配置政策識別碼
 provisioningPolicyId string

雲端電腦的配置政策 ID，由 32 個字元組成，採用 GUID 格式。 政策定義使用者想要建立的雲端電腦類型。
配置政策名稱
 provisioningPolicyName string

在雲端 PC 配置期間適用的配置政策。
本地連線名稱
 onPremisesConnectionName string

在雲端 PC 配置期間，適用的 Azure 網路連線。
服務方案ID
 servicePlanId string

雲端 PC 的服務方案 ID 由 32 個字元組成，格式為 GUID。
服務計畫名稱
 servicePlanName string

服務方案名稱，指的是面向客戶的雲端電腦實體。
狀態
 status string

狀態
使用者主體名稱
 userPrincipalName string

指派給雲端電腦的使用者主體名稱（UPN）。
最後修改日期/時間
 lastModifiedDateTime string

雲端電腦最後修改的日期與時間。 時間戳記類型以 ISO 8601 格式表示日期與時間資訊，且始終以 UTC 為單位。
受管理裝置識別碼
 managedDeviceId string

Intune 註冊的雲端電腦裝置 ID，包含 32 個字元，採用 GUID 格式。
受管理裝置名稱
 managedDeviceName string

雲端電腦的 Intune 註冊裝置名稱。
寬限期結束日期/時間
 gracePeriodEndDateTime string

寬限期結束並進行重新配置或取消的日期和時間。
磁碟加密狀態
 diskEncryptionState string

磁碟加密狀態
配置類型
 provisioningType string

使用此政策配置雲端電腦時應使用的授權類型。
分配顯示名稱
 allotmentDisplayName string

分配顯示名稱
狀態詳情
 statusDetail string

狀態詳情
啟用單一登入
 connectionSetting.enableSingleSignOn boolean

啟用單一登入
partnerAgentInstallResults
 partnerAgentInstallResults array of string

partnerAgentInstallResults

觸發程序

當建立新的配置政策時

允許你在建立配置政策時啟動流程。
當配置政策或雲端電腦更新（棄用）[棄用]

當配置政策或雲端電腦更新（棄用）時
當配置政策更新時

允許你在更新配置政策時觸發流程
當雲端電腦上的遠端動作完成時

允許你在雲端電腦遠端操作完成時觸發流程。
當雲端電腦上的遠端動作被觸發時

允許你在雲端電腦遠端操作完成時觸發流程。
當雲端電腦建立時

這個觸發器允許你在建立雲端電腦時啟動流程。

當建立新的配置政策時

作業識別碼：
WebhookProvisioningPolicyCreated

允許你在建立配置政策時啟動流程。

參數

名稱 機碼 必要 類型 Description
配置政策名稱
 provisioningPolicyNames array of string

選擇一個配置政策來監控更新。
配置政策識別碼
 provisioningPolicyIds array of string

輸入一個或多個配置政策 ID。
配置類型
 provisioningTypeNames array of string

選擇一種或多種配置類型。

傳回

名稱 路徑 類型 Description
array of object
tenantId
 data.tenantId string

tenantId
分類
 data.category string

分類
動作
 data.action string

動作
cloudPCId
 data.data.cloudPCId string

cloudPCId
policyId
 data.data.policyId string

policyId

當配置政策或雲端電腦更新（棄用）[棄用]

作業識別碼：
Webhook

當配置政策或雲端電腦更新（棄用）時

參數

名稱 機碼 必要 類型 Description
情節
 scenario True string

情節

當配置政策更新時

作業識別碼：
WebhookProvisioningPolicyUpdated

允許你在更新配置政策時觸發流程

參數

名稱 機碼 必要 類型 Description
配置政策名稱
 provisioningPolicyNames array of string

選擇一個配置政策來監控更新。
配置政策識別碼
 provisioningPolicyIds array of string

輸入一個或多個配置政策 ID。
配置類型
 provisioningTypeNames array of string

選擇一種或多種配置類型。

傳回

名稱 路徑 類型 Description
array of object
tenantId
 data.tenantId string

tenantId
分類
 data.category string

分類
動作
 data.action string

動作
cloudPCId
 data.data.cloudPCId string

cloudPCId
policyId
 data.data.policyId string

policyId

當雲端電腦上的遠端動作完成時

作業識別碼：
WebhookCloudPcRemoteActionCompleted

允許你在雲端電腦遠端操作完成時觸發流程。

參數

名稱 機碼 必要 類型 Description
配置類型
 provisioningTypeNames array of string

選擇一種或多種配置類型。

傳回

名稱 路徑 類型 Description
array of object
tenantId
 data.tenantId string

tenantId
分類
 data.category string

分類
動作
 data.action string

動作
cloudPCId
 data.data.cloudPCId string

cloudPCId
policyId
 data.data.policyId string

policyId

當雲端電腦上的遠端動作被觸發時

作業識別碼：
WebhookCloudPcRemoteActionTriggered

允許你在雲端電腦遠端操作完成時觸發流程。

參數

名稱 機碼 必要 類型 Description
配置類型
 provisioningTypeNames array of string

選擇一種或多種配置類型。

傳回

名稱 路徑 類型 Description
array of object
tenantId
 data.tenantId string

tenantId
分類
 data.category string

分類
動作
 data.action string

動作
cloudPCId
 data.data.cloudPCId string

cloudPCId
policyId
 data.data.policyId string

policyId

當雲端電腦建立時

作業識別碼：
WebhookCloudPcProvisioned

這個觸發器允許你在建立雲端電腦時啟動流程。

參數

名稱 機碼 必要 類型 Description
配置類型
 provisioningTypeNames array of string

選擇一種或多種配置類型。

傳回

名稱 路徑 類型 Description
array of object
tenantId
 data.tenantId string

tenantId
分類
 data.category string

分類
動作
 data.action string

動作
cloudPCId
 data.data.cloudPCId string

cloudPCId
policyId
 data.data.policyId string

policyId

定義

物件無類型