(预览版)管理环境生命周期、治理、DR、SKU 和环境组。
指令
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
要覆盖目标环境的安全组 ID。
--copy-options-skip-audit-data
用于跳过复制的审核数据的布尔标志。
--validate-only
如果为 true,则验证请求而不执行请求。 与 validateProperties 一起使用,仅验证特定字段;如果 validateProperties 为空,则会验证整个请求。 默认为 false(验证和执行)。
--validate-properties
要验证的属性名称的逗号分隔列表(例如“property1,property2”)。 仅当 validateOnly 为 true 时才适用。
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
创建新环境组的标识的 ID。
--created-by-tenant-id
创建新环境组的标识的租户 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
上次修改新环境组的标识的 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 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
备份的 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
如果为 true,则验证请求而不执行请求。 与 validateProperties 一起使用,仅验证特定字段;如果 validateProperties 为空,则会验证整个请求。 默认为 false(验证和执行)。
--validate-properties
要验证的属性名称的逗号分隔列表(例如“property1,property2”)。 仅当 validateOnly 为 true 时才适用。
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
如果为 true,则验证请求而不执行请求。 与 validateProperties 一起使用,仅验证特定字段;如果 validateProperties 为空,则会验证整个请求。 默认为 false(验证和执行)。
--validate-properties
要验证的属性名称的逗号分隔列表(例如“property1,property2”)。 仅当 validateOnly 为 true 时才适用。
pac environment-management disable-managed-environment
(预览版)禁用指定环境的托管治理。
可选参数 environment-management disable-managed-environment
--environment
-env
指定目标 Dataverse。 该值可以是 Guid 或绝对 https URL。 如果未指定,将使用为当前身份验证配置文件选择的活动组织。
--validate-only
如果为 true,则验证请求而不执行请求。 与 validateProperties 一起使用,仅验证特定字段;如果 validateProperties 为空,则会验证整个请求。 默认为 false(验证和执行)。
--validate-properties
要验证的属性名称的逗号分隔列表(例如“property1,property2”)。 仅当 validateOnly 为 true 时才适用。
pac environment-management enable-disaster-recovery
(预览版)在指定的环境中启用灾难恢复。
可选参数 environment-management enable-disaster-recovery
--environment
-env
指定目标 Dataverse。 该值可以是 Guid 或绝对 https URL。 如果未指定,将使用为当前身份验证配置文件选择的活动组织。
--validate-only
如果为 true,则验证请求而不执行请求。 与 validateProperties 一起使用,仅验证特定字段;如果 validateProperties 为空,则会验证整个请求。 默认为 false(验证和执行)。
--validate-properties
要验证的属性名称的逗号分隔列表(例如“property1,property2”)。 仅当 validateOnly 为 true 时才适用。
pac environment-management enable-managed-environment
(预览版)为指定环境启用托管治理。
可选参数 environment-management enable-managed-environment
--environment
-env
指定目标 Dataverse。 该值可以是 Guid 或绝对 https URL。 如果未指定,将使用为当前身份验证配置文件选择的活动组织。
--validate-only
如果为 true,则验证请求而不执行请求。 与 validateProperties 一起使用,仅验证特定字段;如果 validateProperties 为空,则会验证整个请求。 默认为 false(验证和执行)。
--validate-properties
要验证的属性名称的逗号分隔列表(例如“property1,property2”)。 仅当 validateOnly 为 true 时才适用。
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
如果为 true,则验证请求而不执行请求。 与 validateProperties 一起使用,仅验证特定字段;如果 validateProperties 为空,则会验证整个请求。 默认为 false(验证和执行)。
--validate-properties
要验证的属性名称的逗号分隔列表(例如“property1,property2”)。 仅当 validateOnly 为 true 时才适用。
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
操作 ID。
pac environment-management get-environment-operation-by-id
(预览版)获取在特定环境中范围内的环境生命周期操作的状态,从而在操作查找上启用环境级授权。
所需的参数 environment-management get-environment-operation-by-id
--operation-id
操作的 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
操作的 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
如果为 true,则验证请求而不执行请求。 与 validateProperties 一起使用,仅验证特定字段;如果 validateProperties 为空,则会验证整个请求。 默认为 false(验证和执行)。
--validate-properties
要验证的属性名称的逗号分隔列表(例如“property1,property2”)。 仅当 validateOnly 为 true 时才适用。
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、geostate、和environmentGroupIddomainName。
--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
如果为 true,则验证请求而不执行请求。 与 validateProperties 一起使用,仅验证特定字段;如果 validateProperties 为空,则会验证整个请求。 默认为 false(验证和执行)。
--validate-properties
要验证的属性名称的逗号分隔列表(例如“property1,property2”)。 仅当 validateOnly 为 true 时才适用。
pac environment-management perform-dr-drill
(预览版)为指定环境执行 DR 演练。
可选参数 environment-management perform-dr-drill
--environment
-env
指定目标 Dataverse。 该值可以是 Guid 或绝对 https URL。 如果未指定,将使用为当前身份验证配置文件选择的活动组织。
--validate-only
如果为 true,则验证请求而不执行请求。 与 validateProperties 一起使用,仅验证特定字段;如果 validateProperties 为空,则会验证整个请求。 默认为 false(验证和执行)。
--validate-properties
要验证的属性名称的逗号分隔列表(例如“property1,property2”)。 仅当 validateOnly 为 true 时才适用。
pac environment-management perform-failback
(预览版)对指定环境执行故障回复,将其从当前(配对)区域切换回其原始主要区域。 这是强制故障转移的反函数。
可选参数 environment-management perform-failback
--environment
-env
指定目标 Dataverse。 该值可以是 Guid 或绝对 https URL。 如果未指定,将使用为当前身份验证配置文件选择的活动组织。
--validate-only
如果为 true,则验证请求而不执行请求。 与 validateProperties 一起使用,仅验证特定字段;如果 validateProperties 为空,则会验证整个请求。 默认为 false(验证和执行)。
--validate-properties
要验证的属性名称的逗号分隔列表(例如“property1,property2”)。 仅当 validateOnly 为 true 时才适用。
pac environment-management perform-force-failover
(预览版)将环境故障转移到 LastSyncTime 的配对区域。
可选参数 environment-management perform-force-failover
--environment
-env
指定目标 Dataverse。 该值可以是 Guid 或绝对 https URL。 如果未指定,将使用为当前身份验证配置文件选择的活动组织。
--last-sync-time
要故障转移到的同步时间。 可选:如果为 null 或省略,则故障转移到最新的可用同步点。
--validate-only
如果为 true,则验证请求而不执行请求。 与 validateProperties 一起使用,仅验证特定字段;如果 validateProperties 为空,则会验证整个请求。 默认为 false(验证和执行)。
--validate-properties
要验证的属性名称的逗号分隔列表(例如“property1,property2”)。 仅当 validateOnly 为 true 时才适用。
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
计费策略 ID。
--cluster-category
群集类别。 例如:FirstRelease。
--connected-group-id-for-teams-environment
Microsoft 365预配期间要链接到 Teams 环境的组 ID。 此属性不适用于非 Teams 环境。
--database-type
要创建的数据库类型(例如 CommonDataService)。 CommonDataService 需要位置或 macroRegion、linkedEnvironmentMetadata.baseLanguageCode 和 linkedEnvironmentMetadata.currency.code。
--description
环境的可选说明。
--fin-ops-metadata-id
FinOps 环境 ID。
--fin-ops-metadata-type
FinOps 环境链接类型。
--fin-ops-metadata-url
FinOps 环境 URL。
--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
如果为 true,则验证请求而不执行请求。 与 validateProperties 一起使用,仅验证特定字段;如果 validateProperties 为空,则会验证整个请求。 默认为 false(验证和执行)。
--validate-properties
要验证的属性名称的逗号分隔列表(例如“property1,property2”)。 仅当 validateOnly 为 true 时才适用。
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
要重置到的环境的安全组 ID。
--templates
重置后要应用于环境的模板。 将值作为 JSON 数组提供。
--validate-only
如果为 true,则验证请求而不执行请求。 与 validateProperties 一起使用,仅验证特定字段;如果 validateProperties 为空,则会验证整个请求。 默认为 false(验证和执行)。
--validate-properties
要验证的属性名称的逗号分隔列表(例如“property1,property2”)。 仅当 validateOnly 为 true 时才适用。
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
要覆盖目标环境的安全组 ID。
--restore-options-skip-audit-data
用于在还原期间跳过审核数据的布尔标志。
--validate-only
如果为 true,则验证请求而不执行请求。 与 validateProperties 一起使用,仅验证特定字段;如果 validateProperties 为空,则会验证整个请求。 默认为 false(验证和执行)。
--validate-properties
要验证的属性名称的逗号分隔列表(例如“property1,property2”)。 仅当 validateOnly 为 true 时才适用。
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
更新了创建环境组的标识的 ID。
--created-by-tenant-id
更新了创建环境组的标识的租户 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
更新了上次修改环境组的标识的 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 概述