Windows 365（預覽版）
Windows 365 是一項雲端服務，能自動為終端用戶建立一種新型 Windows 虛擬機 (雲端電腦) 。 每台雲端電腦會被指派給個別使用者，作為專用的 Windows 裝置。 Windows 365 提供 Microsoft 365 的生產力、安全性和共同作業優點。
此連接器適用於以下產品和區域：
| 服務 | Class | Regions |
|---|---|---|
| 副駕駛工作室 | 進階 | 除下列區域外的所有 Power Automate 區域 ： - 美國政府 （GCC） - 美國政府（海灣合作委員會高中） - 由 21Vianet 營運的中國雲 - 美國國防部 （DoD） |
| 邏輯應用程式 | 標準 | 所有 Logic Apps 區域， 但下列區域除外： - Azure Government 區域 - 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運營;生產力 |
Windows 365 連接器提供管理 Windows 365 雲端電腦及 Microsoft Intune 環境中配置政策的操作。 此連接器能讓您透過 Power Automate 流程自動化雲端 PC 生命週期作業、配置政策管理及管理任務。
服務、等級與區域
| 服務 | 類別 | 地區 |
|---|---|---|
| 副駕駛工作室 | 進階 | 所有 Power Automate 區域 |
| 邏輯應用程式 | 進階 | 所有 Logic Apps 區域 |
| Power Apps | 進階 | 所有 Power Apps 區域 |
| Power Automate（自動化服務） | 進階 | 所有 Power Automate 區域 |
連絡人
| 連絡人 | |
|---|---|
| 名稱 | Windows 365 |
| URL | https://learn.microsoft.com/en-us/connectors/windows365 |
W365powerplatform@microsoft.com |
先決條件
若要使用此連接器，您需要：
- 你組織的 Windows 365 授權
- Microsoft Intune 訂用帳戶
- Microsoft Intune 角色導向存取控制（RBAC）中擁有足夠權限來管理 Windows 365 資源
- Azure AD account with appropriate permissions
必要權限
使用者必須具備以下 Intune RBAC 角色之一：
- 全域管理員
- Intune 服務系統管理員
- Windows365 管理員（用於雲端 PC 特定操作）
- 自訂角色與 Windows 365 權限（觸發操作需要
Webhook.Create和Webhook.Delete）
重要提示：此連接器需 Windows 365 授權及適當的 Microsoft Intune RBAC 權限。 所有操作皆使用 Microsoft Graph API，並受 Graph API 限速限制。
已知問題與限制
Windows 365 連接器目前處於公開預覽階段。
在連接器正式發行前，Microsoft 想要確認該連接器是穩定的。 直到那之前，連接器都處於預覽版狀態。 預覽版是「按原貌」提供，「不保證無瑕疵」且「僅可於已發行處取得」。 這些版本已從服務等級協定 (SLAs) 中排除，但是以預覽形式推出，讓您可以搶先體驗並提供意見反應。 了解更多預覽功能及啟用方法。 客戶支援可能不涵蓋預覽。 隨時可能會無預告中止或中斷，而且可能無法進入正式發行階段。
我們鼓勵您試用預覽版連接器並提供意見反應。 這將協助我們穩定並改善連接器。 您可以利用產品論壇來分享問題和意見反應。 預覽功能 (包括連接器) 可能無法使用 Microsoft 支援服務，但是我們會試著盡最大努力提供支援。 欲了解更多，請參閱預覽版連接器 常見問題集。
一般限制
- 其能力與限制與底層的 Graph API 一致。
- 當需要呼叫 Graph beta 端點時，請使用 HTTP 請求動作。
行動
List Cloud PC
行動編號： ListCloudPCs
這個動作可以讓你列出雲端電腦。
參數
| 名稱 | 為必填項目 | 類型 | Description |
|---|---|---|---|
| $select | 否 | 字串 | $select 讓你選擇從 Graph 回傳哪些屬性。 |
| $過濾器 | 否 | 字串 | $filter 允許你從 Graph 取得集合的子集。 |
傳回
| 名稱 | 類型 | Description |
|---|---|---|
| aadDeviceID | 繩子 | Microsoft Entra 雲端電腦裝置 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。 |
| 識別碼 | 繩子 | 面向客戶的雲端電腦實體唯一識別碼，由 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 商業雲端電腦並未自動註冊 Intune。 唯讀。 |
| managedDeviceName | 繩子 | 雲端電腦的 Intune 註冊裝置名稱。 Windows 365 商業雲端電腦的 managedDeviceName 屬性總是空，因為 Windows 365 商業雲電腦並未自動註冊 Intune。 唯讀。 |
| onPremisesConnectionName | 繩子 | 雲端電腦配置期間的本地連線。 唯讀。 |
| provisioningPolicyID | 繩子 | 雲端電腦的配置政策 ID，由 32 個字元組成，採用 GUID 格式。 政策定義使用者想要建立的雲端電腦類型。 唯讀。 |
| provisioningPolicyName | 繩子 | 在雲端 PC 配置期間適用的配置政策。 最大長度為120字元。 唯讀。 |
| provisioningType | 繩子 | 顯示配置類型。 |
| servicePlanId | 繩子 | 雲端 PC 的服務方案 ID 由 32 個字元組成，格式為 GUID。 欲了解更多服務計畫資訊，請參閱 產品名稱及授權服務計畫識別碼。 唯讀。 |
| servicePlanName | 繩子 | 服務方案名稱，指的是面向客戶的雲端 PC 實體。 唯讀。 |
| 服務計畫類型 | 繩子 | 顯示計畫類型。 |
| userPrincipalName | 繩子 | 指派給雲端電腦的使用者主體名稱（UPN）。 最大長度為113個字元。 欲了解更多使用者名稱政策，請參閱 Microsoft Entra ID 中的密碼政策與帳號限制。 唯讀。 |
取得配置政策
行動編號： GetProvisioningPoliciesV1
此操作允許您回傳有關配置政策的資訊。
參數
| 名稱 | 為必填項目 | 類型 | Description |
|---|---|---|---|
| $select | 否 | 繩子 | $select 讓你選擇從 Graph 回傳哪些屬性。 |
| $過濾器 | 否 | 繩子 | $filter 允許你從 Graph 取得集合的子集。 |
| $expand | 否 | 繩子 | $expand 讓你能從 Graph 回傳相關資源。 |
傳回
使用帶有賦值值的$expand，可以看到以下回傳的值：
| 名稱 | 類型 | Description |
|---|---|---|
| cloudPCNamingTemplate | 繩子 | 用來命名使用此政策配置的雲端 PC 的範本。 模板可包含自訂文字與替換標記，包括 %USERNAME：x% 和 %RAND：x%，分別代表使用者姓名與隨機生成的數字。 例如，CPC-%USERNAME：4%-%RAND：5% 表示雲端電腦名稱以 CPC- 開頭，接著是四個字元的用戶名、一個 - 字元，最後是五個隨機字元。 模板產生的文字總長度不得超過 15 個字元。 |
| 說明 | 繩子 | 配置政策描述。 |
| 顯示名稱 | 繩子 | 配置政策的顯示名稱。 |
| domainJoinConfiguration | cloudPcDomainJoinConfiguration collection | 指定一個依優先順序排列的清單，說明雲端電腦如何加入 Microsoft Entra ID（Azure AD）。 |
| enableSingleSignOn | 布林值 | 如果配置好的雲端電腦能透過單一登入存取，那就成立。 錯誤表示已配置的雲端電腦不支援此功能。 預設值為 false。 Windows 365 使用者可以使用單一登入，透過無密碼選項（例如 FIDO 金鑰）來登入 Microsoft Entra ID，以存取他們的雲端電腦 |
| 識別碼 | 繩子 | 與配置政策相關的唯一識別碼。 這個 ID 會在建立新的配置政策時自動填充。 唯讀。 |
| imageDisplayName | 繩子 | 用於配置的作業系統映像檔的顯示名稱。 例如，Windows 11 預覽版 + Microsoft 365 應用程式 23H2 23H2。 |
| imageId | 繩子 | 代表用於配置新雲端 PC 的作業系統映像的唯一識別碼。 圖庫類型的圖片格式為：{publisherName_offerName_skuName}。 每個參數的支援值為：出版商：Microsoftwindowsdesktop 提供：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 |
| 影像類型 | cloudPcProvisioningPolicyImageType | 用於雲端電腦配置的作業系統映像（自訂或圖庫）類型。 可能的數值有：畫廊、自訂。 預設值為畫廊。 |
取得設定政策
行動編號： GetAProvisioningPolicyV1
此操作可讓您取得特定配置政策的詳細資訊。
參數
| 名稱 | 為必填項目 | 類型 | Description |
|---|---|---|---|
| 配置政策識別碼 | Yes | 繩子 | 配置政策的識別碼。 必須包含在內。 |
| $select | 否 | 繩子 | $select 讓你選擇從 Graph 回傳哪些屬性。 |
| $過濾器 | 否 | 繩子 | $filter 允許你從 Graph 取得集合的子集。 |
傳回
此作業會輸出隨機的結果。
建立配置政策
行動編號： CreateAProvisioningPolicyV1
此操作允許您建立配置政策。
參數
| 名稱 | 為必填項目 | 類型 | Description |
|---|---|---|---|
| 名稱 | Yes | 繩子 | 在雲端 PC 配置期間適用的配置政策。 最大長度為120字元 |
| Description | Yes | 繩子 | 配置政策描述。 |
| 網域連接配置 | Yes | ||
| 影像標識碼 | Yes | 繩子 | 這就是你想用來配置雲端電腦的映像 ID。 |
| 影像顯示名稱 | Yes | 繩子 | 雲端電腦所使用的作業系統映像名稱。 最大長度為50字元。 此性質僅允許使用字母（A-Z、a-z）、數字（0-9）及特殊字元（-，_，.）。 房產價值不能以下劃線開始或結束。 |
| 影像類型 | Yes | 繩子 | 自訂或畫廊。 |
| 配置類型 | Yes | 繩子 | 無論是共享還是奉獻。 |
| Windows 設定/區域 | Yes | 繩子 | 提供你想使用的語言或地點。 Windows 365 提供超過 30 種此類語言/區域對。 |
你也可以在 Graph 的進階參數下新增其他欄位。
傳回
此作業會輸出隨機的結果。
指派一個配置政策給群組
行動編號： AssignAProvisioningPolicyToAGroupV1
此操作允許您將群組指派至配置政策。
參數
| 名稱 | 為必填項目 | 類型 | Description |
|---|---|---|---|
| 配置政策識別碼 | Yes | 繩子 | 這是你想要指派群組的配置政策 ID。 |
| 分配 – 目標群組識別碼 | Yes | 繩子 | 來自 Entra ID 的使用者群組。 |
| Assignments – Target ServicePlan ID | 否 | 繩子 | 服務方案的唯一識別碼，指示要為使用者配置的雲端電腦大小。 |
傳回
此作業會輸出隨機的結果。
更新配置政策
行動編號： 更新AProvisioningPolicyV1
此操作允許你更新配置政策。
參數
| 名稱 | 為必填項目 | 類型 | Description |
|---|---|---|---|
| 配置政策識別碼 | Yes | 繩子 | 這是你想更新的配置政策的 ID。 |
| Description | 否 | 繩子 | 這就是配置政策描述將更新到的狀態。 |
你也可以在 Graph 的進階參數下新增其他欄位。
傳回
此作業會輸出隨機的結果。
取得設定政策
行動編號： GetAProvisoningPolicyV1
此操作可讓你取得配置政策的詳細資訊。
參數
| 名稱 | 為必填項目 | 類型 | 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 |
|---|---|---|---|
| Scenario | Yes | 下拉式選單 | 你可以從以下支援的情境中選擇： |
| - 當雲端電腦被建立時 | |||
| - 當建立新的配置政策時 | |||
| - 何時更新配置政策 | |||
| - 當雲端電腦上的遠端動作完成時 | |||
| - 當雲端電腦觸發遠端動作時 |
傳回
此作業會輸出隨機的結果。
節流限制
| 名稱 | 呼叫 | 續約期間 |
|---|---|---|
| 每個連線的 API 呼叫 | 100 | 60 秒 |
動作
| List Cloud PC |
CloudPC 列表 |
| 刪除配置政策 |
刪除一個配置政策。 |
| 取得設定政策 |
會獲得特定的配置政策。 |
| 取得配置政策 |
會拿到一份配置政策清單。 |
| 啟動遠端行動 |
在雲端電腦上啟動遠端操作。 |
| 建立配置政策 |
建立配置政策。 |
| 指派一個配置政策給群組 |
為群組指派一個配置政策。 |
| 更新配置政策 |
更新配置政策。 |
| 發送 Microsoft Graph HTTP 請求（預覽版） |
建構一個 Microsoft Graph REST API 請求 |
| 買一台雲端電腦 |
拿到雲端電腦 |
List Cloud PC
CloudPC 列表
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
選擇
|
$select | string |
選擇要回傳的屬性。 |
|
|
Filter
|
$filter | string |
例如 provisioningPolicyName 等式為 'XXX' 與 userPrincipalName-等式為 'XXX' |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
ID
|
id | string |
面向客戶的雲端電腦實體唯一識別碼，由 32 個字元組成，採用 GUID 格式。 |
|
Entra 裝置 ID
|
aadDeviceId | string |
Microsoft Entra 雲端電腦裝置 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 |
雲端電腦配置期間的 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 |
刪除配置政策
刪除一個配置政策。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
配置政策識別碼
|
id | True | string |
識別碼 |
取得設定政策
會獲得特定的配置政策。
參數
| 名稱 | 機碼 | 必要 | 類型 | 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 |
規定使用此政策配置雲端電腦時所使用的授權類型。 |
取得配置政策
會拿到一份配置政策清單。
參數
| 名稱 | 機碼 | 必要 | 類型 | 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 |
規定使用此政策配置雲端電腦時所使用的授權類型。 |
啟動遠端行動
在雲端電腦上啟動遠端操作。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
雲端 PC ID
|
cloudPcId | True | string |
雲端電腦的唯一識別碼。 |
|
遙控行動
|
remoteAction | True | string |
遠端操作在雲端電腦上執行。 |
|
雲端 PC 快照識別碼
|
cloudPcSnapshotId | string |
修復所需 |
|
|
顯示名稱
|
displayName | string |
更名所需 |
建立配置政策
建立配置政策。
參數
| 名稱 | 機碼 | 必要 | 類型 | 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 |
語言 |
指派一個配置政策給群組
為群組指派一個配置政策。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
配置政策識別碼
|
id | True | string |
識別碼 |
|
配置政策識別碼
|
id | string |
這是你想要指派群組的配置政策 ID |
|
|
群組識別碼
|
groupId | True | string |
groupId |
|
servicePlanId
|
servicePlanId | string |
目標服務計畫識別碼 |
更新配置政策
更新配置政策。
參數
| 名稱 | 機碼 | 必要 | 類型 | 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 請求（預覽版）
建構一個 Microsoft Graph REST API 請求
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
URI
|
Uri | True | string |
完整或相對 URI。 範例： |
|
方法
|
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
買一台雲端電腦
拿到雲端電腦
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
雲端 PC ID
|
cloudPcId | True | string |
雲端電腦的唯一識別碼。 |
|
選擇
|
$select | string |
選擇要回傳的屬性。 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
ID
|
id | string |
面向客戶的雲端電腦實體唯一識別碼，由 32 個字元組成，採用 GUID 格式。 |
|
Entra 裝置 ID
|
aadDeviceId | string |
Microsoft Entra 雲端電腦裝置 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 |
雲端電腦配置期間的 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 |
觸發程序
| 當配置政策或雲端電腦更新時 |
當配置政策或雲端電腦更新時 |
當配置政策或雲端電腦更新時
當配置政策或雲端電腦更新時
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
情節
|
scenario | True | string |
情節 |