pac 管理员

使用 Power Platform 管理员帐户

指令

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

pac 管理员添加组

将环境添加到组。

管理员加载项组的必需参数

--environment-group -eg

环境组。

管理员加载项组的可选参数

--environment -env

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

pac 管理员应用程序列表

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

pac 管理员应用程序注册

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

管理员应用程序注册所需的参数

--application-id -id

应用程序 ID

pac 管理员应用程序注销

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

管理员应用程序注销所需的参数

--application-id -id

应用程序 ID

pac 管理员 assign-group

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

管理员分配组所需的参数

--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

管理员分配组的可选参数

--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

管理员分配用户所需的参数

--role -r

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

--user -u

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

管理员分配用户的可选参数

--application-user -au

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

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

--async -a

已弃用:忽略此参数。

--business-unit -bu

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

--environment -env

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

pac 管理员备份

手动备份环境。

Example

为环境创建手动备份

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

管理员备份所需的参数

--label -l

按提供设置备份标签。

管理员备份的可选参数

--environment -env

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

pac 管理员副本

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

例子

以下示例演示了命令的使用 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

管理员复制的可选参数

--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 管理员创建

在租户中创建 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

管理员创建所需的参数

--type -t

设置环境类型。

使用以下值之一:

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

用于管理员创建的可选参数

--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 管理员 create-service-principal

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

Example

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

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

管理员 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 管理员删除

从租户中删除环境。

例子

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

按 GUID 删除环境

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

按 URL 删除环境

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

用于管理员删除的可选参数

--async -a

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

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

--environment -env

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

--max-async-wait-time -wt

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

pac 管理员列表

列出租户中的所有环境。

例子

以下示例演示了命令的使用 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

管理员列表的可选参数

--application -a

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

--environment -env

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

--name -n

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

--type -t

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

使用以下值之一:

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

--json

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

pac 管理员 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

管理员 list-app-templates 的可选参数

--region -r

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

pac 管理员列表备份

列出环境的所有备份。

例子

以下示例演示了命令的使用 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

管理员列表备份的可选参数

--environment -env

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

pac 管理员列表组

列出租户中的环境组。

pac 管理员 list-service-principal

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

管理员 list-service-principal 的可选参数

--filter -f

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

--max -m

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

pac 管理员 list-tenant-settings

列出租户设置。

管理员 list-tenant-settings 的可选参数

--settings-file -s

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

pac 管理员重置

从租户重置环境。

例子

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

重置租户中的环境

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

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

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

管理员重置的可选参数

--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 管理员还原

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

例子

以下示例演示了命令的使用 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

管理员还原所需的参数

--selected-backup -sb

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

用于管理员还原的可选参数

--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 管理员 set-backup-retention-period

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

管理员 set-backup-retention-period 所需的参数

--backup-retention-period -br

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

管理员 set-backup-retention-period 的可选参数

--async -a

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

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

--environment -env

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

--max-async-wait-time -wt

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

pac admin set-governance-config

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

管理员 set-governance-config 所需的参数

--environment -env

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

--protection-level -pl

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

使用以下值之一:

  • Basic
  • Standard

管理员 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 管理员 set-runtime-state

更新环境管理模式。

管理员 set-runtime-state 的必需参数

--environment -env

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

--runtime-state -rs

环境运行时状态

使用以下值之一:

  • AdminMode
  • Enabled

管理员 set-runtime-state 的可选参数

--async -a

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

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

--background-operations -bo

环境后台作状态

使用以下值之一:

  • Enabled
  • Disabled

--max-async-wait-time -wt

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

pac 管理员状态

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

pac 管理员 update-tenant-settings

更新租户设置。

管理员 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 概述