共用方式為


pac admin

使用您的 Power Platform 管理員帳戶

Commands

Command Description
pac admin add-group 將環境新增至群組。
pac admin application list 列出在租用戶下註冊的 Microsoft Entra ID 應用程式。
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 的 Microsoft Entra ID 應用程式。
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

列出在租用戶下註冊的 Microsoft Entra ID 應用程式。

pac admin application register

向租用戶註冊 Microsoft Entra ID 應用程式。

所需參數 admin application register

--application-id -id

應用程式識別碼

pac admin application unregister

從租用戶取消註冊 Microsoft Entra ID 應用程式。

所需參數 admin application unregister

--application-id -id

應用程式識別碼

pac admin assign-group

將群組指派給具有指定資訊安全角色的目標 Dataverse 環境。

所需參數 admin assign-group

--group -g

要指派給目標 Dataverse 環境的群組的 Microsoft Entra ID 物件識別碼。

--group-name -gn

要在 Dataverse 中建立的群組或小組名稱。

--membership-type -mt

團隊成員資格類型。

使用下列其中一個值:

  • MembersAndGuests
  • Members
  • Owners
  • Guests

--role -r

要套用至使用者的資訊安全角色名稱或識別碼

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

要套用至使用者的資訊安全角色名稱或識別碼

--user -u

要指派給環境的 Microsoft Entra 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 使用方式。

簡單創建環境

在此範例中,我們將使用預設設定建立沙箱環境:

  • 貨幣:美元
  • 語言:英語
  • 地區:美國

我們不需要新增這些屬性,因為這些值是預設值。

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

在此範例中,我們會建立 環境的進階建立中所述的相同環境,但參考名為 where 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

設定用於您環境的貨幣。 [默認為美元]

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

設定環境的區域名稱。 [預設為美國]

--security-group-id -sgid

Microsoft Entra ID 安全性群組識別碼或 Microsoft 365 群組識別碼 (Teams 環境的必要專案)。

附註: 安全性群組識別碼必須是有效的 Guid。

--templates -tm

設定需要部署的 Dynamics 365 應用程式,以逗號分隔值傳遞。 例如:-tm「D365_Sample,D365_Sales」

--user -u

要指派給環境的 Microsoft Entra 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

要套用至應用程式使用者之資訊安全角色的名稱或識別碼。 預設值為:「系統管理員」。

備註

成功後,會顯示四個資料行:

  • Power Platform 租用戶識別碼
  • 應用程式識別碼
  • 用戶端密碼 (純文字)
  • Expiration

例如:

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 或識別碼。

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

設定環境的區域名稱。 [預設為美國]

pac admin list-backups

列出您環境的所有備份。

範例

下列範例顯示命令的 pac admin list-backups 使用方式。

依識別碼列出環境中的備份

此範例會根據環境識別碼列出環境的備份。

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 的 Microsoft Entra ID 應用程式。

可選參數 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

重設租用戶中的環境,並將貨幣設定為歐元

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

可選參數 admin reset

--async -a

可選的布林參數用於非同步執行 pac 動詞,預設為 false。

此參數不需要任何值。 這是一個開關。

--currency -c

設定用於您環境的貨幣。 [默認為美元]

--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 用法:

還原最新備份

此範例會將具有識別碼 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' 格式或字串「最新」。

可選參數 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 系統管理中心首頁卡片中包含深入解析。

此參數不需要任何值。 這是一個開關。

--limit-sharing-mode -lsm

限制共享模式。

--maker-onboarding-markdown -mom

Maker 上線降價

--maker-onboarding-url -mou

製作者上線 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 概觀