使用 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
团队成员身份类型。
使用以下值之一:
MembersAndGuestsMembersOwnersGuests
--role
-r
要应用于用户的安全角色的名称或 ID
--team-type
-tt
团队类型。
使用以下值之一:
OwnerAccessAadSecurityGroupAadOfficeGroup
管理员分配组的可选参数
--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
使用以下值之一:
MinimalCopyFullCopy
--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
设置环境类型。
使用以下值之一:
TrialSandboxProductionDeveloperTeamsSubscriptionBasedTrial
用于管理员创建的可选参数
--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
列出具有给定类型的所有环境。
使用以下值之一:
TrialSandboxProductionDeveloperTeamsSubscriptionBasedTrial
--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
设置保护级别:“标准”以启用托管环境,将“基本”设置为禁用托管环境。
使用以下值之一:
BasicStandard
管理员 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
解决方案检查器验证模式。
使用以下值之一:
nonewarnblock
--suppress-validation-emails
-sve
阻止验证电子邮件
此参数不需要任何值。 这是一个开关。
pac 管理员 set-runtime-state
更新环境管理模式。
管理员 set-runtime-state 的必需参数
--environment
-env
需要更新管理模式的环境的 URL 或 ID。
--runtime-state
-rs
环境运行时状态
使用以下值之一:
AdminModeEnabled
管理员 set-runtime-state 的可选参数
--async
-a
用于异步运行 pac 谓词的可选布尔参数,默认为 false。
此参数不需要任何值。 这是一个开关。
--background-operations
-bo
环境后台作状态
使用以下值之一:
EnabledDisabled
--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 概述