(預告)管理環境生命週期、治理、災難復原、SKU 及環境群組。
Commands
pac environment-management add-environment-to-group
(預告)將環境加入環境群組。
所需參數 environment-management add-environment-to-group
--group-id
群組 ID。
可選參數 environment-management add-environment-to-group
--environment
-env
指定目標 Dataverse。 值可以是 Guid 或絕對 https URL。 如果未指定,則會使用為目前驗證設定檔選取的作用中組織。
pac environment-management copy-environment
(預告)將指定來源的環境複製到目標。
所需參數 environment-management copy-environment
--copy-type
代表複製操作的類型。
使用下列其中一個值:
MinimalFull
--source-environment-id
來源環境 ID 可複製。
--target-environment-id
將被覆寫的目標環境的 ID。
可選參數 environment-management copy-environment
--copy-options-environment-name-to-override
環境名稱可覆蓋目標環境。
--copy-options-execute-advanced-copy-for-finance-and-operations
布林標誌用於執行財務與營運資料的進階複製。
--copy-options-security-group-id-to-override
安全群組識別碼可覆蓋目標環境。
--copy-options-skip-audit-data
布林標誌以跳過文案中的稽核資料。
--validate-only
當為真時,驗證請求但未執行。 使用 validProperties 只驗證特定欄位;若 validProperties 為空,則整個請求被驗證。 預設為 false(驗證並執行)。
--validate-properties
一個逗號分隔的屬性名稱清單(例如「property1,property2」)。 僅當 validOnly 為真時才適用。
pac environment-management create-environment-backup
(預告)建立指定環境的備份。
所需參數 environment-management create-environment-backup
--label
手動建立備份的標籤。
可選參數 environment-management create-environment-backup
--environment
-env
指定目標 Dataverse。 值可以是 Guid 或絕對 https URL。 如果未指定,則會使用為目前驗證設定檔選取的作用中組織。
pac environment-management create-environment-group
(預告)成立環境團體。
可選參數 environment-management create-environment-group
--children-group-ids
提供 JSON 陣列的值。
--created-by-display-name
顯示創建新環境群組的身份名稱。
--created-by-email
建立新環境群組的身份電子郵件地址。
--created-by-id
創建新環境群組的身份識別碼。
--created-by-tenant-id
建立新環境群組的租戶識別碼。
--created-by-type
新環境群組創建者的身份類型。
--created-by-user-principal-name
創建新環境群組的身份的使用者主體名稱。
--created-time
為新環境群組錄製建立時間。
--description
新環境小組的說明。
--display-name
新環境群組的顯示名稱。
--id
ID 要指派到新的環境群組。
--last-modified-by-display-name
顯示最後修改新環境群組的身份名稱。
--last-modified-by-email
最後修改新環境群組的身份電子郵件地址。
--last-modified-by-id
最後修改新環境群組的身份識別碼。
--last-modified-by-tenant-id
最後修改新環境群組的租戶身份識別碼。
--last-modified-by-type
新環境群組最後修飾符的身份類型。
--last-modified-by-user-principal-name
最後修改新環境群組的身份主體名稱。
--last-modified-time
新環境群組的最後修改時間。
--parent-group-id
新環境群組的父群組識別碼。
pac environment-management create-environment-management-settings
(預告)建立環境管理設定。
所需參數 environment-management create-environment-management-settings
--body
JSON 請求主體,或 @<path> 從檔案讀取。
可選參數 environment-management create-environment-management-settings
--environment
-env
指定目標 Dataverse。 值可以是 Guid 或絕對 https URL。 如果未指定,則會使用為目前驗證設定檔選取的作用中組織。
pac environment-management delete-environment-backup
(預告)刪除指定的備份。
所需參數 environment-management delete-environment-backup
--backup-id
備份的標識碼。
可選參數 environment-management delete-environment-backup
--environment
-env
指定目標 Dataverse。 值可以是 Guid 或絕對 https URL。 如果未指定,則會使用為目前驗證設定檔選取的作用中組織。
pac environment-management delete-environment-by-id
(預告)依 ID 刪除指定的環境。
可選參數 environment-management delete-environment-by-id
--environment
-env
指定目標 Dataverse。 值可以是 Guid 或絕對 https URL。 如果未指定,則會使用為目前驗證設定檔選取的作用中組織。
--validate-only
當為真時,驗證請求但未執行。 使用 validProperties 只驗證特定欄位;若 validProperties 為空,則整個請求被驗證。 預設為 false(驗證並執行)。
--validate-properties
一個逗號分隔的屬性名稱清單(例如「property1,property2」)。 僅當 validOnly 為真時才適用。
pac environment-management delete-environment-group
(預告)刪除環境群組。
所需參數 environment-management delete-environment-group
--group-id
群組 ID。
pac environment-management disable-disaster-recovery
(預告)在指定環境中停用災難復原。
可選參數 environment-management disable-disaster-recovery
--environment
-env
指定目標 Dataverse。 值可以是 Guid 或絕對 https URL。 如果未指定,則會使用為目前驗證設定檔選取的作用中組織。
--validate-only
當為真時,驗證請求但未執行。 使用 validProperties 只驗證特定欄位;若 validProperties 為空,則整個請求被驗證。 預設為 false(驗證並執行)。
--validate-properties
一個逗號分隔的屬性名稱清單(例如「property1,property2」)。 僅當 validOnly 為真時才適用。
pac environment-management disable-managed-environment
(預告)禁用指定環境的管理治理。
可選參數 environment-management disable-managed-environment
--environment
-env
指定目標 Dataverse。 值可以是 Guid 或絕對 https URL。 如果未指定,則會使用為目前驗證設定檔選取的作用中組織。
--validate-only
當為真時,驗證請求但未執行。 使用 validProperties 只驗證特定欄位;若 validProperties 為空,則整個請求被驗證。 預設為 false(驗證並執行)。
--validate-properties
一個逗號分隔的屬性名稱清單(例如「property1,property2」)。 僅當 validOnly 為真時才適用。
pac environment-management enable-disaster-recovery
(預告)能在指定環境中進行災難復原。
可選參數 environment-management enable-disaster-recovery
--environment
-env
指定目標 Dataverse。 值可以是 Guid 或絕對 https URL。 如果未指定,則會使用為目前驗證設定檔選取的作用中組織。
--validate-only
當為真時,驗證請求但未執行。 使用 validProperties 只驗證特定欄位;若 validProperties 為空,則整個請求被驗證。 預設為 false(驗證並執行)。
--validate-properties
一個逗號分隔的屬性名稱清單(例如「property1,property2」)。 僅當 validOnly 為真時才適用。
pac environment-management enable-managed-environment
(預告)為指定環境實現受管治理。
可選參數 environment-management enable-managed-environment
--environment
-env
指定目標 Dataverse。 值可以是 Guid 或絕對 https URL。 如果未指定,則會使用為目前驗證設定檔選取的作用中組織。
--validate-only
當為真時,驗證請求但未執行。 使用 validProperties 只驗證特定欄位;若 validProperties 為空,則整個請求被驗證。 預設為 false(驗證並執行)。
--validate-properties
一個逗號分隔的屬性名稱清單(例如「property1,property2」)。 僅當 validOnly 為真時才適用。
pac environment-management get-business-continuity-state-full-snapshot
(預告)取得業務持續性快照,包括 LastSyncTime。
可選參數 environment-management get-business-continuity-state-full-snapshot
--environment
-env
指定目標 Dataverse。 值可以是 Guid 或絕對 https URL。 如果未指定,則會使用為目前驗證設定檔選取的作用中組織。
pac environment-management get-environment-backups
(預告)取得指定環境的備份。
可選參數 environment-management get-environment-backups
--columns
表格輸出中包含的回應屬性,並以逗號分隔。 完整回應請使用 --json。
--environment
-env
指定目標 Dataverse。 值可以是 Guid 或絕對 https URL。 如果未指定,則會使用為目前驗證設定檔選取的作用中組織。
pac environment-management get-environment-by-id-for-user
(預告)依 ID 檢索單一環境。
可選參數 environment-management get-environment-by-id-for-user
--environment
-env
指定目標 Dataverse。 值可以是 Guid 或絕對 https URL。 如果未指定,則會使用為目前驗證設定檔選取的作用中組織。
--select
以逗號分隔的屬性清單,列出應包含在回應中。
pac environment-management get-environment-copy-candidates
(預告)取得可複製為目標環境的環境清單。
所需參數 environment-management get-environment-copy-candidates
--source-environment-id
要複製的來源環境 ID。
可選參數 environment-management get-environment-copy-candidates
--columns
表格輸出中包含的回應屬性,並以逗號分隔。 完整回應請使用 --json。
--validate-only
當為真時,驗證請求但未執行。 使用 validProperties 只驗證特定欄位;若 validProperties 為空,則整個請求被驗證。 預設為 false(驗證並執行)。
--validate-properties
一個逗號分隔的屬性名稱清單(例如「property1,property2」)。 僅當 validOnly 為真時才適用。
pac environment-management get-environment-group
(預告)找環境團體。
所需參數 environment-management get-environment-group
--group-id
群組 ID。
pac environment-management get-environment-group-operation
(預告)查詢行動狀態。
所需參數 environment-management get-environment-group-operation
--operation-id
作業標識碼。
pac environment-management get-environment-operation-by-id
(預告)取得特定環境下環境生命週期操作的狀態,允許在操作查詢時進行環境層級授權。
所需參數 environment-management get-environment-operation-by-id
--operation-id
作業的標識碼。
--target-environment-id
目標環境的ID。
可選參數 environment-management get-environment-operation-by-id
--columns
表格輸出中包含的回應屬性,並以逗號分隔。 完整回應請使用 --json。
pac environment-management get-operation-by-id
(預告)取得環境生命週期操作的狀態。
所需參數 environment-management get-operation-by-id
--operation-id
作業的標識碼。
可選參數 environment-management get-operation-by-id
--columns
表格輸出中包含的回應屬性,並以逗號分隔。 完整回應請使用 --json。
pac environment-management get-operations-for-environment
(預告)列出特定環境的生命週期操作。
可選參數 environment-management get-operations-for-environment
--columns
表格輸出中包含的回應屬性,並以逗號分隔。 完整回應請使用 --json。
--continuation-token
一個由先前回應回傳的不透明令牌,用來取得下一頁的結果。 省略取回第一頁。
--environment
-env
指定目標 Dataverse。 值可以是 Guid 或絕對 https URL。 如果未指定,則會使用為目前驗證設定檔選取的作用中組織。
--limit
每個請求可回傳的最大紀錄數。 必須是正整數;若省略,則會設定伺服器預設值。
pac environment-management get-provisioning-currencies
(預告)擷取可用貨幣以供地點環境配置。
所需參數 environment-management get-provisioning-currencies
--location
位置名稱。
可選參數 environment-management get-provisioning-currencies
--columns
表格輸出中包含的回應屬性,並以逗號分隔。 完整回應請使用 --json。
pac environment-management get-provisioning-languages
(預告)擷取地點環境中可用的語言。
所需參數 environment-management get-provisioning-languages
--location
位置名稱。
可選參數 environment-management get-provisioning-languages
--columns
表格輸出中包含的回應屬性,並以逗號分隔。 完整回應請使用 --json。
pac environment-management get-provisioning-templates
(預告)擷取地點環境中可用的範本。
所需參數 environment-management get-provisioning-templates
--location
位置名稱。
可選參數 environment-management get-provisioning-templates
--columns
表格輸出中包含的回應屬性,並以逗號分隔。 完整回應請使用 --json。
pac environment-management get-restore-candidates
(預告)從指定環境還原時,會取得還原候選清單。
所需參數 environment-management get-restore-candidates
--source-environment-id
還原的來源環境 ID。
可選參數 environment-management get-restore-candidates
--columns
表格輸出中包含的回應屬性,並以逗號分隔。 完整回應請使用 --json。
--validate-only
當為真時,驗證請求但未執行。 使用 validProperties 只驗證特定欄位;若 validProperties 為空,則整個請求被驗證。 預設為 false(驗證並執行)。
--validate-properties
一個逗號分隔的屬性名稱清單(例如「property1,property2」)。 僅當 validOnly 為真時才適用。
pac environment-management get-supported-locations
(預告)取得支援的環境配置地點清單。
可選參數 environment-management get-supported-locations
--columns
表格輸出中包含的回應屬性,並以逗號分隔。 完整回應請使用 --json。
pac environment-management link-dataverse
(預告)將 Dataverse 實例連結到現有環境。
可選參數 environment-management link-dataverse
--base-language-code
基礎語言代碼(例如英語為1033)。
--currency-code
貨幣代碼(例如美元)。
--currency-name
貨幣名稱。
--currency-precision
貨幣的精準度。
--currency-symbol
貨幣符號。
--domain-name
網域名稱。
--environment
-env
指定目標 Dataverse。 值可以是 Guid 或絕對 https URL。 如果未指定,則會使用為目前驗證設定檔選取的作用中組織。
--security-group-id
安全群組ID。
--template-metadata
一個為所選範本客製化的 JSON 物件有效載荷。 以 JSON 物件形式提供該值。
--templates
套用範本。 提供 JSON 陣列的值。
pac environment-management list-environment-groups
(預告)列出環境群組。
可選參數 environment-management list-environment-groups
--columns
表格輸出中包含的回應屬性,並以逗號分隔。 完整回應請使用 --json。
pac environment-management list-environment-management-settings
(預告)取得 ID 的環境管理設定。
可選參數 environment-management list-environment-management-settings
--columns
表格輸出中包含的回應屬性,並以逗號分隔。 完整回應請使用 --json。
--environment
-env
指定目標 Dataverse。 值可以是 Guid 或絕對 https URL。 如果未指定,則會使用為目前驗證設定檔選取的作用中組織。
--select
要為此實體選取的屬性清單。
--top
要擷取的記錄數。 如果沒設定,預設是 500。
pac environment-management list-environments-for-user
(預告)回傳已驗證使用者可用的環境清單。
可選參數 environment-management list-environments-for-user
--columns
表格輸出中包含的回應屬性,並以逗號分隔。 完整回應請使用 --json。
--filter
OData 過濾器表達式以限制回傳的環境集合。 支援的濾波屬性包括 dataverseId、 type、 geostateenvironmentGroupIddomainName和 。
--ids
以逗號分隔的環境 ID 清單,需取得資料。 指定時,僅回傳符合這些 ID 的環境。
--orderby
OData 按順序表達式用於排序結果。
--select
以逗號分隔的屬性清單,列出應包含在回應中。
--skip
跳過多少個環境才會回傳結果。
--top
可回歸的環境數量上限。
pac environment-management modify-environment-sku
(預告)針對指定環境修改 sku。
所需參數 environment-management modify-environment-sku
--environment-sku
環境 SKU。
使用下列其中一個值:
StandardPremiumDeveloperBasicProductionSandboxTrialDefaultSupportSubscriptionBasedTrialTeamsPlatform
可選參數 environment-management modify-environment-sku
--environment
-env
指定目標 Dataverse。 值可以是 Guid 或絕對 https URL。 如果未指定,則會使用為目前驗證設定檔選取的作用中組織。
--validate-only
當為真時,驗證請求但未執行。 使用 validProperties 只驗證特定欄位;若 validProperties 為空,則整個請求被驗證。 預設為 false(驗證並執行)。
--validate-properties
一個逗號分隔的屬性名稱清單(例如「property1,property2」)。 僅當 validOnly 為真時才適用。
pac environment-management perform-dr-drill
(預告)針對指定環境執行災難演練。
可選參數 environment-management perform-dr-drill
--environment
-env
指定目標 Dataverse。 值可以是 Guid 或絕對 https URL。 如果未指定,則會使用為目前驗證設定檔選取的作用中組織。
--validate-only
當為真時,驗證請求但未執行。 使用 validProperties 只驗證特定欄位;若 validProperties 為空,則整個請求被驗證。 預設為 false(驗證並執行)。
--validate-properties
一個逗號分隔的屬性名稱清單(例如「property1,property2」)。 僅當 validOnly 為真時才適用。
pac environment-management perform-failback
(預告)對指定環境執行備援,將其從目前(配對)區域切回原始主要區域。 這就是強制故障轉移的反向。
可選參數 environment-management perform-failback
--environment
-env
指定目標 Dataverse。 值可以是 Guid 或絕對 https URL。 如果未指定,則會使用為目前驗證設定檔選取的作用中組織。
--validate-only
當為真時,驗證請求但未執行。 使用 validProperties 只驗證特定欄位;若 validProperties 為空,則整個請求被驗證。 預設為 false(驗證並執行)。
--validate-properties
一個逗號分隔的屬性名稱清單(例如「property1,property2」)。 僅當 validOnly 為真時才適用。
pac environment-management perform-force-failover
(預告)在 LastSyncTime 時,環境故障切換到其配對區域。
可選參數 environment-management perform-force-failover
--environment
-env
指定目標 Dataverse。 值可以是 Guid 或絕對 https URL。 如果未指定,則會使用為目前驗證設定檔選取的作用中組織。
--last-sync-time
切換到同步時間。 可選:若為空或省略,則故障切換至最新可用的同步點。
--validate-only
當為真時,驗證請求但未執行。 使用 validProperties 只驗證特定欄位;若 validProperties 為空,則整個請求被驗證。 預設為 false(驗證並執行)。
--validate-properties
一個逗號分隔的屬性名稱清單(例如「property1,property2」)。 僅當 validOnly 為真時才適用。
pac environment-management provision-new-environment
(預告)供應一個新環境。
所需參數 environment-management provision-new-environment
--display-name
環境的顯示名稱。
--environment-sku
環境 SKU。
使用下列其中一個值:
StandardPremiumDeveloperBasicProductionSandboxTrialDefaultSupportSubscriptionBasedTrialTeamsPlatform
可選參數 environment-management provision-new-environment
--billing-policy-id
帳單原則識別碼。
--cluster-category
群集類別。 例如:FirstRelease。
--connected-group-id-for-teams-environment
Microsoft 365 群組 ID 將在配置過程中與 Teams 環境連結。 此特性不適用於非 Teams 環境。
--database-type
建立的資料庫類型(例如 CommonDataService)。 CommonDataService 需要位置或巨集區域、linkedEnvironmentMetadata.baseLanguageCode 以及 linkedEnvironmentMetadata.currency.code。
--description
環境的可選描述。
--fin-ops-metadata-id
FinOps 環境 ID。
--fin-ops-metadata-type
FinOps 環境連結類型。
--fin-ops-metadata-url
FinOps 環境的網址。
--governance-configuration-protection-level
環境治理保護層級。
使用下列其中一個值:
BasicStandard
--linked-environment-metadata-base-language-code
基礎語言代碼(例如英語為1033)。
--linked-environment-metadata-currency
環境中的貨幣設定。 以 JSON 物件形式提供該值。
--linked-environment-metadata-domain-name
網域名稱。
--linked-environment-metadata-security-group-id
安全群組ID。
--linked-environment-metadata-template-metadata
一個為所選範本客製化的 JSON 物件有效載荷。 以 JSON 物件形式提供該值。
--linked-environment-metadata-templates
套用範本。 提供 JSON 陣列的值。
--location
環境配置的位置。 與 MacroRegion 互斥。
--macro-region
環境將被供應的巨集區域。
--parent-environment-group-id
環境群組 ID。
--used-by-display-name
使用者的顯示名稱。
--used-by-tenant-id
使用者的租戶 ID。
--used-by-type
使用者身份的類型(例如,使用者)。
--used-by-user-id
使用者的 ID。
pac environment-management recover-environment
(預告)恢復已刪除的環境。
可選參數 environment-management recover-environment
--environment
-env
指定目標 Dataverse。 值可以是 Guid 或絕對 https URL。 如果未指定,則會使用為目前驗證設定檔選取的作用中組織。
--validate-only
當為真時,驗證請求但未執行。 使用 validProperties 只驗證特定欄位;若 validProperties 為空,則整個請求被驗證。 預設為 false(驗證並執行)。
--validate-properties
一個逗號分隔的屬性名稱清單(例如「property1,property2」)。 僅當 validOnly 為真時才適用。
pac environment-management remove-environment-from-group
(預告)將環境從環境群組中移除。
所需參數 environment-management remove-environment-from-group
--group-id
群組 ID。
可選參數 environment-management remove-environment-from-group
--environment
-env
指定目標 Dataverse。 值可以是 Guid 或絕對 https URL。 如果未指定,則會使用為目前驗證設定檔選取的作用中組織。
pac environment-management reset-environment
(預告)重置指定的環境。
可選參數 environment-management reset-environment
--base-language-code
環境重置的基礎語言代碼(例如英文為 1033)。
--currency-code
貨幣代碼(例如美元)。
--currency-name
貨幣名稱。
--currency-precision
貨幣的精準度。
--currency-symbol
貨幣符號。
--description
一個可選的環境描述,用來重置。
--display-name
環境的顯示名稱,用來重置。
--domain-name
用來重置環境的網域名稱。
--environment
-env
指定目標 Dataverse。 值可以是 Guid 或絕對 https URL。 如果未指定,則會使用為目前驗證設定檔選取的作用中組織。
--security-group-id
用於重置環境的安全群組識別碼。
--templates
重置後可套用於環境的範本。 提供 JSON 陣列的值。
--validate-only
當為真時,驗證請求但未執行。 使用 validProperties 只驗證特定欄位;若 validProperties 為空,則整個請求被驗證。 預設為 false(驗證並執行)。
--validate-properties
一個逗號分隔的屬性名稱清單(例如「property1,property2」)。 僅當 validOnly 為真時才適用。
pac environment-management restore-environment
(預告)將指定的環境還原到先前的備份。
所需參數 environment-management restore-environment
--restore-point-date-time
恢復環境的時間點。 必須依據 RFC 3339 包含時區偏移(例如 2025-04-30T12:34:56+02:00)。
--source-environment-id
備份將從中還原的來源環境 ID。
--target-environment-id
將被覆寫的目標環境的 ID。
可選參數 environment-management restore-environment
--restore-options-environment-name-to-override
環境名稱可覆蓋目標環境。
--restore-options-security-group-id-to-override
安全群組識別碼可覆蓋目標環境。
--restore-options-skip-audit-data
在還原時用布林標誌跳過稽核資料。
--validate-only
當為真時,驗證請求但未執行。 使用 validProperties 只驗證特定欄位;若 validProperties 為空,則整個請求被驗證。 預設為 false(驗證並執行)。
--validate-properties
一個逗號分隔的屬性名稱清單(例如「property1,property2」)。 僅當 validOnly 為真時才適用。
pac environment-management update-environment-group
(預告)更新環境群組。
所需參數 environment-management update-environment-group
--group-id
群組 ID。
可選參數 environment-management update-environment-group
--children-group-ids
提供 JSON 陣列的值。
--created-by-display-name
更新了創建環境群組的身份顯示名稱。
--created-by-email
建立環境群組的身份更新電子郵件地址。
--created-by-id
更新了創建環境群組的身份識別碼。
--created-by-tenant-id
更新了建立環境群組的身份的租戶 ID。
--created-by-type
環境群組創建者的更新身份類型。
--created-by-user-principal-name
更新了建立環境群組的身份的使用者主體名稱。
--created-time
更新了建立時間以記錄環境群組。
--description
環境群組的更新說明。
--display-name
環境群組的顯示名稱已更新。
--id
更新的識別碼可應用於環境群組。
--last-modified-by-display-name
更新了最後修改環境群組的身份的顯示名稱。
--last-modified-by-email
更新了最後修改環境群組的身份電子郵件地址。
--last-modified-by-id
更新了最後修改環境群組的身份識別碼。
--last-modified-by-tenant-id
更新了最後修改環境群組的身份的租戶 ID。
--last-modified-by-type
更新了環境群組最後修飾符的身份類型。
--last-modified-by-user-principal-name
更新了最後修改環境群組的身份主體名稱。
--last-modified-time
更新了最後修改的時間,以記錄環境群組。
--parent-group-id
更新了環境群組的父群組 ID。
pac environment-management update-environment-management-settings
(預告)更新環境管理設定中的欄位。
所需參數 environment-management update-environment-management-settings
--body
JSON 請求主體,或 @<path> 從檔案讀取。
可選參數 environment-management update-environment-management-settings
--environment
-env
指定目標 Dataverse。 值可以是 Guid 或絕對 https URL。 如果未指定,則會使用為目前驗證設定檔選取的作用中組織。
另請參閱
Microsoft Power Platform CLI 指令群組
Microsoft Power Platform CLI 概述