pac admin

使用 Power Platform 管理员帐户

指令

Command Description
pac admin add-group 将环境添加到组。
pac admin application list 列出在租户下注册的 entra ID 应用程序Microsoft。
pac admin application register 向租户注册Microsoft Entra ID 应用程序。
pac admin application unregister 从租户中注销Microsoft Entra ID 应用程序。
pac admin assign-group 将组分配到具有指定安全角色的目标 Dataverse 环境。
pac admin assign-user 将用户分配到具有指定安全角色的目标 Dataverse 环境。
pac admin backup 手动备份环境。
pac admin copy 将源环境复制到目标环境。
pac admin create 在租户中创建 Dataverse 实例。
pac admin create-service-principal 将 Microsoft Entra ID 应用程序和关联的应用程序用户添加到 Dataverse 环境。
pac admin delete 从租户中删除环境。
pac admin list 列出租户中的所有环境。
pac admin list-app-templates 列出 Dynamics 365 中模型驱动应用的所有受支持的 Dataverse 模板。
pac admin list-backups 列出环境的所有备份。
pac admin list-groups 列出租户中的环境组。
pac admin list-service-principal 列出有权访问 Dataverse 的 entra ID 应用程序Microsoft。
pac admin list-tenant-settings 列出租户设置。
pac admin reset 从租户重置环境。
pac admin restore 将环境还原到给定的备份。
pac admin set-backup-retention-period 按提供设置备份保留期(以天为单位)。 有效值为:7、14、21、28。
pac admin set-governance-config 启用、禁用和编辑托管环境。
pac admin set-runtime-state 更新环境管理模式。
pac admin status 此命令列出正在进行的所有作的状态。
pac admin update-tenant-settings 更新租户设置。

pac admin add-group

将环境添加到组。

所需的参数 admin add-group

--environment-group -eg

环境组。

可选参数 admin add-group

--environment -env

环境(ID、组织 ID、URL、唯一名称或部分名称)。

pac admin application list

列出在租户下注册的 entra ID 应用程序Microsoft。

pac admin application register

向租户注册Microsoft Entra ID 应用程序。

所需的参数 admin application register

--application-id -id

应用程序 ID

pac admin application unregister

从租户中注销Microsoft Entra ID 应用程序。

所需的参数 admin application unregister

--application-id -id

应用程序 ID

pac admin assign-group

将组分配到具有指定安全角色的目标 Dataverse 环境。

所需的参数 admin assign-group

--group -g

Microsoft要分配给目标 Dataverse 环境的组的 Entra ID 对象 ID。

--group-name -gn

在 Dataverse 中创建的组或团队的名称。

--membership-type -mt

团队成员身份类型。

使用以下值之一:

  • MembersAndGuests
  • Members
  • Owners
  • Guests

--role -r

要应用于用户的安全角色的名称或 ID

--team-type -tt

团队类型。

使用以下值之一:

  • Owner
  • Access
  • AadSecurityGroup
  • AadOfficeGroup

可选参数 admin assign-group

--business-unit -bu

要与应用程序用户关联的业务部门的 ID。

--environment -env

要向其分配用户的环境的 ID 或 URL。

pac admin assign-user

将用户分配到具有指定安全角色的目标 Dataverse 环境。

例子

以下示例演示了命令的使用 pac admin assign-user

通过电子邮件将用户分配到具有基本用户角色的环境

pac admin assign-user `
  --environment 00000000-0000-0000-0000-000000000000 `
  --user "user@company.com" `
  --role "Basic User"

通过 guid 将用户分配到具有系统管理员角色的环境,并将用户添加到指定的业务部门

pac admin assign-user `
  --environment 00000000-0000-0000-0000-000000000000 `
  --user 00000000-0000-0000-0000-000000000000 `
  --business-unit` 00000000-0000-0000-0000-000000000000 `
  --role "System Administrator"

将应用程序用户分配到具有系统管理员角色的环境

pac admin assign-user `
  --environment 00000000-0000-0000-0000-000000000000 `
  --user 00000000-0000-0000-0000-000000000000 `
  --role "System Administrator"
  --application-user

所需的参数 admin assign-user

--role -r

要应用于用户的安全角色的名称或 ID

--user -u

要分配给环境或应用程序 ID 的 Microsoft Entra ID 用户的对象 ID 或用户主体名称 (UPN),如果分配应用程序用户。

可选参数 admin assign-user

--application-user -au

指定输入用户是否为应用程序用户。 如果未指定业务部门,则会将应用程序用户添加到经过身份验证的用户业务部门。

此参数不需要任何值。 这是一个开关。

--async -a

已弃用:忽略此参数。

--business-unit -bu

要与应用程序用户关联的业务部门的 ID。

--environment -env

要向其分配用户的环境的 ID 或 URL。

pac admin backup

手动备份环境。

Example

为环境创建手动备份

pac admin backup `
  --environment 00000000-0000-0000-0000-000000000000 `
  --label "Manual Backup October 2022"

所需的参数 admin backup

--label -l

按提供设置备份标签。

可选参数 admin backup

--environment -env

需要备份的环境的环境 URL 或 ID。

pac admin copy

将源环境复制到目标环境。

例子

以下示例演示了命令的使用 pac admin copy

使用最小副本将环境从源环境复制到目标环境

此示例仅将自定义项和架构从源环境复制到目标环境。

pac admin copy `
  --name "Environment Name" `
  --source-env 00000000-0000-0000-0000-000000000000 `
  --target-env 00000000-0000-0000-0000-000000000000 `
  --type MinimalCopy

使用完整副本将环境从源环境复制到目标环境

此示例将整个环境从源环境复制到目标环境。

pac admin copy `
  --name "Environment Name" `
  --source-env 00000000-0000-0000-0000-000000000000 `
  --target-env 00000000-0000-0000-0000-000000000000 `
  --type FullCopy

可选参数 admin copy

--async -a

用于异步运行 pac 谓词的可选布尔参数,默认为 false。

此参数不需要任何值。 这是一个开关。

--max-async-wait-time -wt

最大异步等待时间(以分钟为单位)。 默认值为 60 分钟。

--name -n

目标环境的名称。

--skip-audit-data -sa

指示是否应跳过审核数据的开关

此参数不需要任何值。 这是一个开关。

--source-env -se

正在复制的源环境的环境 URL 或 ID

--target-env -te

目标环境的环境 URL 或 ID。

--type -t

使用以下值之一:

  • MinimalCopy
  • FullCopy

--json

以 JSON 格式字符串的形式返回命令的输出。

pac admin create

在租户中创建 Dataverse 实例。

例子

以下示例演示了命令的使用 pac admin create

简单创建环境

在此示例中,我们将使用默认设置创建沙盒环境:

  • 货币:美元
  • 语言:英语
  • 区域:unitedstates

我们不必添加这些属性,因为这些值是默认值。

pac admin create `
  --name "Contoso Test" `
  --type Sandbox `
  --domain ContosoTest

环境的高级创建

在此示例中,我们将在欧洲区域创建生产环境,货币设置为欧元,语言设置为英语。

我们不必添加语言属性,因为它是默认值。

pac admin create `
  --name "Contoso Marketing" `
  --currency EUR `
  --region europe `
  --type Production `
  --domain ContosoMarketing

使用 --input-file 创建

在此示例中,我们将创建环境 高级创建中所述的相同环境,但引用名为 config.json config.json 包含此数据的 JSON 文件中的数据除外:

{
  "name": "Contoso Marketing",
  "currency": "EUR",
  "region": "europe",
  "type": "Production",
  "domain": "ContosoMarketing"
}

然后,使用 pac admin create 命令时引用该文件:

pac admin create --input-file C:\config.json

所需的参数 admin create

--type -t

设置环境类型。

使用以下值之一:

  • Trial
  • Sandbox
  • Production
  • Developer
  • Teams
  • SubscriptionBasedTrial

可选参数 admin create

--async -a

用于异步运行 pac 谓词的可选布尔参数,默认为 false。

此参数不需要任何值。 这是一个开关。

--currency -c

设置用于环境的货币。 [默认值为 USD]

--domain -d

域名是环境 URL 的一部分。 如果域名已在使用中,则会将数值追加到域名中。 例如:如果“contoso”已在使用中,则环境 URL 将更新为 https://{contoso}0.crm.dynamics.com。

注意:仅允许范围 [A - Z]、[a - z]、[0 - 9]或“-”中的字符。 第一个字符和最后一个字符不能是“-”字符。 不允许连续的“-”字符。

--input-file -if

要传入 .json 输入文件中的谓词参数。 例如:{“name”: “contoso”}。 通过命令行传递的参数优先于 .json 输入文件中的参数。

--language -l

设置用于环境的语言。 [默认值为英语]

--max-async-wait-time -wt

最大异步等待时间(以分钟为单位)。 默认值为 60 分钟。

--name -n

设置环境的名称。

--region -r

设置环境的区域名称。 [defaults to unitedstates]

--security-group-id -sgid

Microsoft条目 ID 安全组 ID 或 Microsoft 365 组 ID(Teams 环境需要)。

注意:安全组 ID 必须是有效的 Guid。

--templates -tm

设置需要部署的 Dynamics 365 应用,以逗号分隔值的形式传递。 例如:-tm“D365_Sample,D365_Sales”

--user -u

要分配给环境的Microsoft Entra ID 用户的对象 ID 或用户主体名称(UPN)。

--json

以 JSON 格式字符串的形式返回命令的输出。

pac admin create-service-principal

将 Microsoft Entra ID 应用程序和关联的应用程序用户添加到 Dataverse 环境。

Example

pac admin create-service-principal  --environment <environment id>

详细信息: 使用服务主体配置服务连接

可选参数 admin create-service-principal

--environment -env

环境(ID、组织 ID、URL、唯一名称或部分名称)。

--name -n

在 Entra ID 中创建的应用程序名称。

--role -r

要应用于应用程序用户的安全角色的名称或 ID。 默认值为:“系统管理员”。

注解

成功后,将显示四列:

  • Power Platform 租户 ID
  • 应用程序 ID
  • 客户端密码(以明文形式)
  • 过期日期

例如:

PS C:\>pac admin create-service-principal --environment d3fcc479-0122-e7af-9965-bde57f69ee1d
Connected as admin@M365x57236226.onmicrosoft.com
Successfully assigned user adde6d52-9582-4932-a43a-beca5d182301 to environment d3fcc479-0122-e7af-9965-bde57f69eeld with security role System Administrator
Tenant ID                            Application ID                       Client Secret                           Expiration
2b0463ed-efd7-419d-927d-a9dca49d899c adde6d52-9582-4932-a43a-beca5d182301 beY8Q~JBZ~CBDgIKKBjbZ3g6BofKzoZkYj23Hbf 7/31/2024 4:27:03 PM

pac admin delete

从租户中删除环境。

例子

以下示例演示了命令的使用 pac admin delete

按 GUID 删除环境

pac admin delete --environment 00000000-0000-0000-0000-000000000000

按 URL 删除环境

pac admin delete --environment https://contosomarketing.crm4.dynamics.com

可选参数 admin delete

--async -a

用于异步运行 pac 谓词的可选布尔参数,默认为 false。

此参数不需要任何值。 这是一个开关。

--environment -env

需要从租户中删除的环境的环境 URL 或 ID。

--max-async-wait-time -wt

最大异步等待时间(以分钟为单位)。 默认值为 60 分钟。

pac admin list

列出租户中的所有环境。

例子

以下示例演示了命令的使用 pac admin list

列出租户中的所有环境

此示例将列出租户中的所有环境。

pac admin list

下面显示了输出示例。

Environment   Environment Id                        Environment Url                        Type        Organization Id
Contoso       00000000-0000-0000-0000-000000000000  https://contoso.crm.dynamics.com/      Production  00000000-0000-0000-0000-000000000000
Contoso Dev   00000000-0000-0000-0000-000000000000  https://contoso-dev.crm.dynamics.com/  Sandbox     00000000-0000-0000-0000-000000000000
Contoso Test  00000000-0000-0000-0000-000000000000  https://commdemos.crm.dynamics.com/    Sandbox     00000000-0000-0000-0000-000000000000

列出租户中的所有沙盒环境

本示例将列出类型 Sandbox租户中的所有环境。

pac admin list --type Sandbox

下面显示了输出示例。

Environment  Environment Id                        Environment Url                        Type        Organization Id
Contoso Dev  00000000-0000-0000-0000-000000000000  https://contoso-dev.crm.dynamics.com/  Sandbox     00000000-0000-0000-0000-000000000000
Contoso Test 00000000-0000-0000-0000-000000000000  https://commdemos.crm.dynamics.com/    Sandbox     00000000-0000-0000-0000-000000000000

可选参数 admin list

--application -a

列出已安装指定应用程序的所有环境。 若要指定应用程序,请使用唯一的名称或 ID。

--environment -env

列出名称或 ID 中包含给定字符串的所有环境。

--name -n

列出名称中包含给定字符串的所有环境。

--type -t

列出具有给定类型的所有环境。

使用以下值之一:

  • Trial
  • Sandbox
  • Production
  • Developer
  • Teams
  • SubscriptionBasedTrial

--json

以 JSON 格式字符串的形式返回命令的输出。

pac admin list-app-templates

列出 Dynamics 365 中模型驱动应用的所有受支持的 Dataverse 模板。

例子

以下示例使用 pac admin list-app-templates 命令:

列出所有受支持的 Dataverse 数据库模板

此示例列出了 Dynamics 365 中模型驱动应用的所有受支持的 Dataverse 数据库模板。

pac admin list-app-templates

下面显示了输出示例。

Template Name               Template Location Template Display Name Is Disabled
D365_CDSSampleApp           unitedstates      Sample App            False
D365_CustomerService        unitedstates      Customer Service      True
D365_CustomerServicePro     unitedstates      Customer Service Pro  True
D365_DeveloperEdition       unitedstates      Developer Edition     False
D365_FieldService           unitedstates      Field Service         True
D365_Guides                 unitedstates      Guides                True
D365_PowerFrameworkTemplate unitedstates      Power Framework       False
D365_ProjectOperations      unitedstates      Project Operations    True
D365_RemoteAssist           unitedstates      Remote Assist         True
D365_Sales                  unitedstates      Sales Enterprise      True
D365_SalesPro               unitedstates      Sales Pro             True
D365_SmbMarketing           unitedstates      SMB Marketing         True

列出 Dynamics 365 for Region Europe 中模型驱动应用的所有受支持的 Dataverse 数据库模板

此示例列出了欧洲区域 Dynamics 365 中模型驱动应用的所有受支持的 Dataverse 数据库模板。

pac admin list-app-templates --region Europe

下面显示了输出示例。

Template Name               Template Location Template Display Name Is Disabled
D365_CDSSampleApp           Europe            Sample App            False
D365_CustomerService        Europe            Customer Service      True
D365_CustomerServicePro     Europe            Customer Service Pro  True
D365_DeveloperEdition       Europe            Developer Edition     True
D365_FieldService           Europe            Field Service         True
D365_Guides                 Europe            Guides                True
D365_PowerFrameworkTemplate Europe            Power Framework       True
D365_ProjectOperations      Europe            Project Operations    True
D365_RemoteAssist           Europe            Remote Assist         True
D365_Sales                  Europe            Sales Enterprise      True
D365_SalesPro               Europe            Sales Pro             True
D365_SmbMarketing           Europe            SMB Marketing         True

可选参数 admin list-app-templates

--region -r

设置环境的区域名称。 [defaults to unitedstates]

pac admin list-backups

列出环境的所有备份。

例子

以下示例演示了命令的使用 pac admin list-backups

按 ID 列出环境中的备份

此示例根据环境 ID 列出环境的备份。

pac admin list-backups --environment 00000000-0000-0000-0000-000000000000

下面显示了输出示例。

 Index   Id                                      Label        Expiry                Point Date
 1       00000000-0000-0000-0000-000000000000    Backup       14/12/2022 12:50:38   07/12/2022 12:50:38

按 URL 列出环境中的备份

此示例根据环境 URL 列出环境的备份。

pac admin list-backups --environment https://contoso.crm.dynamics.com

可选参数 admin list-backups

--environment -env

列出在其环境 ID 或 URL 中包含给定字符串的所有环境。

pac admin list-groups

列出租户中的环境组。

pac admin list-service-principal

列出有权访问 Dataverse 的 entra ID 应用程序Microsoft。

可选参数 admin list-service-principal

--filter -f

应用程序名称“开头”筛选器。

--max -m

要显示的最大应用程序数。 默认值:20

pac admin list-tenant-settings

列出租户设置。

可选参数 admin list-tenant-settings

--settings-file -s

要输出租户设置的 .json 文件。

pac admin reset

从租户重置环境。

例子

以下示例演示了命令的使用 pac admin reset

重置租户中的环境

pac admin reset --environment 00000000-0000-0000-0000-000000000000

重置租户中的环境,并将货币设置为 EUR

pac admin reset --environment 00000000-0000-0000-0000-000000000000 --currency EUR

可选参数 admin reset

--async -a

用于异步运行 pac 谓词的可选布尔参数,默认为 false。

此参数不需要任何值。 这是一个开关。

--currency -c

设置用于环境的货币。 [默认值为 USD]

--domain -d

域名是环境 URL 的一部分。 如果域名已在使用中,则会将数值追加到域名中。 例如:如果“contoso”已在使用中,则环境 URL 将更新为 https://{contoso}0.crm.dynamics.com。

--environment -env

需要重置的环境的 URL 或 ID。

--input-file -if

要传入 .json 输入文件中的谓词参数。 例如:{“name”: “contoso”}。 通过命令行传递的参数优先于 .json 输入文件中的参数。

--language -l

设置用于环境的语言。 [默认值为英语]

--max-async-wait-time -wt

最大异步等待时间(以分钟为单位)。 默认值为 60 分钟。

--name -n

设置环境的名称。

--purpose -p

设置用于将环境与特定意向关联的说明。

--templates -tm

设置需要部署的 Dynamics 365 应用,以逗号分隔值的形式传递。 例如:-tm“D365_Sample,D365_Sales”

--json

以 JSON 格式字符串的形式返回命令的输出。

pac admin restore

将环境还原到给定的备份。

例子

以下示例演示了命令的使用 pac admin restore

还原最新备份

此示例将当前活动身份验证配置文件中当前选择的环境从 ID 00000000-0000-0000-0000-000000000000 的源环境还原最新备份。

pac admin restore --selected-backup latest --source-env 00000000-0000-0000-0000-000000000000

基于时间戳还原备份

本示例将从源12/01/2022 09:00环境创建的00000000-0000-0000-0000-000000000000备份还原到当前活动身份验证配置文件中当前选择的环境。

pac admin restore --selected-backup '12/01/2022 09:00' --source-env 00000000-0000-0000-0000-000000000000

所需的参数 admin restore

--selected-backup -sb

格式为 "mm/dd/yyyy hh:mm" 的备份的日期时间或字符串 "latest"。

可选参数 admin restore

--async -a

用于异步运行 pac 谓词的可选布尔参数,默认为 false。

此参数不需要任何值。 这是一个开关。

--max-async-wait-time -wt

最大异步等待时间(以分钟为单位)。 默认值为 60 分钟。

--name -n

已还原环境的可选名称。

--skip-audit-data -sa

指示是否应跳过审核数据的开关

此参数不需要任何值。 这是一个开关。

--source-env -se

还原所需的源环境 URL 或 ID。

--target-env -te

还原所需的目标环境的环境 URL 或 ID。 如果未提供,则默认为源 URL/ID。

--json

以 JSON 格式字符串的形式返回命令的输出。

pac admin set-backup-retention-period

按提供设置备份保留期(以天为单位)。 有效值为:7、14、21、28。

所需的参数 admin set-backup-retention-period

--backup-retention-period -br

按提供设置备份保留期(以天为单位)。 有效值为:7、14、21、28。

可选参数 admin set-backup-retention-period

--async -a

用于异步运行 pac 谓词的可选布尔参数,默认为 false。

此参数不需要任何值。 这是一个开关。

--environment -env

需要备份的环境的环境 URL 或 ID。

--max-async-wait-time -wt

最大异步等待时间(以分钟为单位)。 默认值为 60 分钟。

pac admin set-governance-config

启用、禁用和编辑托管环境。

所需的参数 admin set-governance-config

--environment -env

需要为其启用、禁用或编辑托管环境的环境的 URL 或 ID。

--protection-level -pl

设置保护级别:“标准”以启用托管环境,将“基本”设置为禁用托管环境。

使用以下值之一:

  • Basic
  • Standard

可选参数 admin set-governance-config

--checker-rule-overrides -cro

解决方案检查器规则替代

--cloud-flows-limit -cfl

创建者可以与之共享解决方案云流的人数

--cloud-flows-mode -cfm

解决方案云流限制共享模式

--disable-group-sharing -dgs

禁用组共享。

此参数不需要任何值。 这是一个开关。

--exclude-analysis -ea

从每周摘要电子邮件中排除环境的使用情况见解。

此参数不需要任何值。 这是一个开关。

--include-insights -ii

在 Power Platform Admin Center 主页卡中包含见解。

此参数不需要任何值。 这是一个开关。

--limit-sharing-mode -lsm

限制共享模式。

--maker-onboarding-markdown -mom

Maker 载入 Markdown

--maker-onboarding-url -mou

Maker 载入 URL

--max-limit-user-sharing -ml

如果禁用组共享,请指定创建者可以与之共享画布应用的人数。

--solution-checker-mode -scm

解决方案检查器验证模式。

使用以下值之一:

  • none
  • warn
  • block

--suppress-validation-emails -sve

阻止验证电子邮件

此参数不需要任何值。 这是一个开关。

pac admin set-runtime-state

更新环境管理模式。

所需的参数 admin set-runtime-state

--environment -env

需要更新管理模式的环境的 URL 或 ID。

--runtime-state -rs

环境运行时状态

使用以下值之一:

  • AdminMode
  • Enabled

可选参数 admin set-runtime-state

--async -a

用于异步运行 pac 谓词的可选布尔参数,默认为 false。

此参数不需要任何值。 这是一个开关。

--background-operations -bo

环境后台作状态

使用以下值之一:

  • Enabled
  • Disabled

--max-async-wait-time -wt

最大异步等待时间(以分钟为单位)。 默认值为 60 分钟。

pac admin status

此命令列出正在进行的所有作的状态。

pac admin update-tenant-settings

更新租户设置。

可选参数 admin update-tenant-settings

--setting-name -n

要更新的设置的名称。 例如:powerPlatform.helpSupportSettings.useSupportBingSearchByAllUsers

--setting-value -v

要更新的设置的值。

--settings-file -s

具有租户设置的 .json 文件。

注解

可以在 PowerShell 的“启用环境路由”中找到使用此命令的示例。

另请参阅

Microsoft Power Platform CLI 命令组
Microsoft Power Platform CLI 概述