通过

pac 身份验证

管理如何向各种服务进行身份验证

连接到租户

使用 pac auth create 命令 连接到租户。 运行 pac auth create 在计算机上创建身份验证配置文件。 可以有多个可用的身份验证配置文件。 使用多个租户时，具有多个身份验证配置文件很有趣。 例如，当你的公司使用多个租户（用于开发、生产和测试），或者你是一名面向多个客户的顾问时。

该 pac auth create 命令具有几个有用的参数：

  • 该 --environment 参数使你能够自动连接到正确的环境。 如果省略参数 --environment ，则连接到默认环境，但添加 --environment 参数后，可以连接到其他环境。 可以使用环境 ID、URL、唯一名称或部分名称作为值。

  • 在无法使用交互式体验的环境中，添加 --deviceCode 参数可确保你仍然可以连接。 例如，在 GitHub Codespaces 中， --deviceCode 运行 pac auth create时会自动添加参数。

Example

若要连接到 HR-Dev 环境，可以使用以下示例：

pac auth create --environment "HR-Dev"

切换到另一个身份验证配置文件

如果有多个身份验证配置文件，可以使用 pac 身份验证列表 和 pac 身份验证选择 命令轻松切换。

该 pac auth list 命令会列出计算机上的所有身份验证配置文件。 该 pac auth select 命令选择其他命令。

pac auth list 例

若要列出所有身份验证配置文件，请使用以下示例：

pac auth list

pac auth list运行该命令将返回所有身份验证配置文件：

Index Active Kind      Name Friendly Name                   Url                                 User                                     Cloud  Type
[1]   *      UNIVERSAL      Personal Productivity (Default) https://x.crm.dynamics.com/         user@contoso.onmicrosoft.com             Public User

使用索引值选择其他身份验证配置文件。

pac auth select --index 2

指令

Command Description
pac 身份验证清除 清除此计算机上存储的所有身份验证配置文件
pac 身份验证创建 在此计算机上创建和存储身份验证配置文件
pac 身份验证删除 删除特定身份验证配置文件
pac 身份验证列表 列出此计算机上存储的身份验证配置文件
pac 身份验证名称 命名或重命名现有身份验证配置文件
pac 身份验证选择 选择应处于活动状态的身份验证配置文件
pac 身份验证更新 更新现有身份验证配置文件的名称或目标环境
pac 身份验证人员 显示有关当前所选身份验证配置文件的信息

pac 身份验证清除

清除此计算机上存储的所有身份验证配置文件

pac 身份验证创建

在此计算机上创建和存储身份验证配置文件

例子

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

基本创建

本示例将提示输入凭据并连接到凭据所属的租户。

pac auth create

注释

在 Codespaces 中运行 Power Platform CLI 时，这将触发设备代码登录。

环境创建

此示例将提示输入凭据，并使用指定的环境 ID 连接到 Power Platform 环境。

pac auth create --environment < Your environment ID >

小窍门

若要查找环境 ID，请执行以下作：

  1. 打开 Power Platform 管理中心 ，然后选择要连接到 的环境 。 在“ 详细信息 ”部分中，查找 环境 ID

命名创建

此示例使用租户进行身份验证，并为其指定名称 MyOrg。

pac auth create --name MyOrg

使用服务主体命名创建

此示例使用租户进行身份验证，为其指定名称 MyOrg-SPN ，并使用服务主体执行此作。 不要忘记将服务主体添加到环境。

pac auth create --name MyOrg-SPN --applicationId 00000000-0000-0000-0000-000000000000 --clientSecret $clientSecret --tenant 00000000-0000-0000-0000-000000000000

身份验证创建的可选参数

--applicationId -id

可选：要进行身份验证的应用程序 ID。

--azureDevOpsFederated -adof

（预览版）对服务主体身份验证使用 Azure DevOps 联合身份验证;需要 --tenant 和 --applicationId 参数

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

--certificateDiskPath -cdp

可选：用于进行身份验证的证书磁盘路径

--certificatePassword -cp

可选：用于进行身份验证的证书密码

--clientSecret -cs

可选：要通过 进行身份验证的客户端密码

--cloud -ci

可选：要通过 进行身份验证的云实例

使用以下值之一：

  • Public
  • UsGov
  • UsGovHigh
  • UsGovDod
  • China

--deviceCode -dc

使用 Microsoft Entra ID 设备代码流进行交互式登录。

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

--environment -env

默认环境（ID、URL、唯一名称或部分名称）。

--githubFederated -ghf

（预览版）使用 GitHub 联合身份验证进行服务主体身份验证;需要 --tenant 和 --applicationId 参数

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

--managedIdentity -mi

使用 Azure 托管标识。

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

--name -n

要为此身份验证配置文件提供的名称（最多 30 个字符）。

注意：名称的长度应介于 1 到 30 之间

--password -p

可选：要通过 进行身份验证的密码

--tenant -t

如果使用应用程序 ID/客户端密码或应用程序 ID/客户端证书，则租户 ID。

--url -u

已弃用：改用 --environment 。

--username -un

可选：要进行身份验证的用户名;如果未指定，则显示Microsoft Entra ID 对话框。

注解

cloud对于参数，要使用的值映射到以下其他常见首字母缩略词或名称：

  • GCC = UsGov
  • GCC High = UsGovHigh
  • DoD = UsGovDod

pac 身份验证删除

删除特定身份验证配置文件

Example

pac auth delete --index 2

身份验证删除的可选参数

--index -i

要删除的配置文件的索引

注意：该值必须是最小值为 1 的整数。

--name -n

要处于活动状态的配置文件的名称

注意：名称的长度应介于 1 到 30 之间

pac 身份验证列表

列出此计算机上存储的身份验证配置文件

pac 身份验证名称

命名或重命名现有身份验证配置文件

Example

以下示例演示如何重命名身份验证配置文件。 在这种情况下，索引为 1 的配置文件将重命名为“Contoso Dev”。

pac auth name --index 1 --name "Contoso Dev"

身份验证名称所需的参数

--index -i

要命名/重命名的配置文件的索引

注意：该值必须是最小值为 1 的整数。

--name -n

要为此身份验证配置文件提供的名称（最多 30 个字符）。

注意：名称的长度应介于 1 到 30 之间

pac 身份验证选择

选择应处于活动状态的身份验证配置文件

Example

pac auth select --index 2

身份验证选择的可选参数

--index -i

要处于活动状态的配置文件的索引。

注意：该值必须是最小值为 1 的整数。

--name -n

要处于活动状态的配置文件的名称

注意：名称的长度应介于 1 到 30 之间

pac 身份验证更新

更新现有身份验证配置文件的名称或目标环境

例子

以下示例演示如何使用 pac auth update 命令。

使用环境 URL 更新身份验证配置文件

此示例演示如何使用索引 1 使用名称和 Contoso Dev 环境 URL https://contosodev.crm.dynamics.com更新身份验证配置文件。

pac auth update --index 1 --name "Contoso Dev" --environment "https://contosodev.crm.dynamics.com"

使用环境 ID 更新身份验证配置文件

此示例演示如何使用环境 ID 00000000-0000-0000-0000-000000000000更新索引 1 的身份验证配置文件。

pac auth update --index 1 --environment 00000000-0000-0000-0000-000000000000

身份验证更新所需的参数

--index -i

要命名/重命名的配置文件的索引

注意：该值必须是最小值为 1 的整数。

身份验证更新的可选参数

--environment -env

默认环境（ID、URL、唯一名称或部分名称）。

--name -n

要为此身份验证配置文件提供的名称（最多 30 个字符）。

pac 身份验证人员

显示有关当前所选身份验证配置文件的信息

另请参阅

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