使用您的 Power Platform 管理員帳戶
Commands
| Command | Description |
|---|---|
| pac管理員add-group | 將環境新增至群組。 |
| PAC 管理員應用程式清單 | 列出在租用戶下註冊的 Microsoft Entra ID 應用程式。 |
| PAC 管理員應用程式註冊 | 向租用戶註冊 Microsoft Entra ID 應用程式。 |
| PAC 管理員應用程式取消註冊 | 從租用戶取消註冊 Microsoft Entra ID 應用程式。 |
| pac管理員assign-group | 將群組指派給具有指定資訊安全角色的目標 Dataverse 環境。 |
| pac 管理員 assign-user | 將使用者指派給具有指定資訊安全角色的目標 Dataverse 環境。 |
| PAC 管理員備份 | 手動備份您的環境。 |
| pac 管理員副本 | 將來源環境複製到目的地環境。 |
| pac admin 建立 | 在您的租用戶中建立 Dataverse 執行個體。 |
| pac admin create-service-principal | 將 Microsoft Entra ID 應用程式和相關聯的應用程式使用者新增至 Dataverse 環境。 |
| PAC 管理員刪除 | 從租用戶刪除環境。 |
| PAC 管理員列表 | 列出租使用者中的所有環境。 |
| pac管理員清單-應用程式-範本 | 列出 Dynamics 365 中模型導向應用程式的所有支援 Dataverse 範本。 |
| pac admin list-backups | 列出您環境的所有備份。 |
| pac admin list-groups | 列出租用戶中的環境群組。 |
| pac admin list-service-principal | 列出有權存取 Dataverse 的 Microsoft Entra ID 應用程式。 |
| pac 管理員清單租戶設定 | 列出租用戶設定。 |
| PAC 管理員重設 | 從租用戶重設環境。 |
| PAC 管理員還原 | 將環境還原為指定的備份。 |
| pac admin set-backup-retention-period | 設定備份保留期間 (以天為單位) 如提供。 有效值為:7、14、21、28。 |
| pac admin set-governance-config | 啟用、停用和編輯受管理環境。 |
| pac 管理員 set-runtime-state | 更新環境管理模式。 |
| PAC 管理員狀態 | 此指令會列出所有進行中作業的狀態。 |
| pac 管理員 update-tenant-settings | 更新租用戶設定。 |
pac管理員add-group
將環境新增至群組。
admin add-group的必要引數
--environment-group
-eg
環境群組。
admin add-group的選用引數
--environment
-env
環境 (ID、組織 ID、URL、唯一名稱或部分名稱)。
PAC 管理員應用程式清單
列出在租用戶下註冊的 Microsoft Entra ID 應用程式。
PAC 管理員應用程式註冊
向租用戶註冊 Microsoft Entra ID 應用程式。
系統管理應用程式註冊的必要參數
--application-id
-id
應用程式識別碼
PAC 管理員應用程式取消註冊
從租用戶取消註冊 Microsoft Entra ID 應用程式。
系統管理應用程式取消註冊的必要參數
--application-id
-id
應用程式識別碼
pac管理員assign-group
將群組指派給具有指定資訊安全角色的目標 Dataverse 環境。
admin assign-group的必要引數
--group
-g
要指派給目標 Dataverse 環境的群組的 Microsoft Entra ID 物件識別碼。
--group-name
-gn
要在 Dataverse 中建立的群組或小組名稱。
--membership-type
-mt
團隊成員資格類型。
使用下列其中一個值:
MembersAndGuestsMembersOwnersGuests
--role
-r
要套用至使用者的資訊安全角色名稱或識別碼
--team-type
-tt
團隊類型。
使用下列其中一個值:
OwnerAccessAadSecurityGroupAadOfficeGroup
admin assign-group的選用引數
--business-unit
-bu
要與應用程式使用者相關聯的業務單位 ID。
--environment
-env
要指派使用者的環境的 ID 或 URL。
pac 管理員 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
管理員的必要引數 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 管理員備份
手動備份您的環境。
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 admin 建立
在您的租用戶中建立 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
管理員建立的必要參數
--type
-t
設定環境類型。
使用下列其中一個值:
TrialSandboxProductionDeveloperTeamsSubscriptionBasedTrial
管理員建立的選擇性參數
--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 管理員刪除
從租用戶刪除環境。
範例
下列範例顯示命令的 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 或識別碼。
--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管理員清單-應用程式-範本
列出 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
設定環境的區域名稱。 [預設為美國]
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 的選用引數
--settings-file
-s
輸出租戶設定的 .json 檔案。
PAC 管理員重設
從租用戶重設環境。
範例
下列範例顯示命令的 pac admin reset 用法:
重設租使用者中的環境
pac admin reset --environment 00000000-0000-0000-0000-000000000000
重設租用戶中的環境,並將貨幣設定為歐元
pac admin reset --environment 00000000-0000-0000-0000-000000000000 --currency EUR
管理員重設的選擇性參數
--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 管理員還原
將環境還原為指定的備份。
範例
下列範例顯示命令的 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
系統管理還原的必要參數
--selected-backup
-sb
備份的日期時間為 'mm/dd/yyyy hh:mm' 格式或字串「最新」。
系統管理員還原的選擇性參數
--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
設定保護層級:「標準」可啟用受管理環境,「基本」可停用受管理環境。
使用下列其中一個值:
BasicStandard
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
解決方案檢查器驗證模式。
使用下列其中一個值:
nonewarnblock
--suppress-validation-emails
-sve
隱藏驗證電子郵件
此參數不需要任何值。 這是一個開關。
pac 管理員 set-runtime-state
更新環境管理模式。
admin set-runtime-state的必要引數
--environment
-env
需要更新管理模式之環境的 URL 或 ID。
--runtime-state
-rs
環境執行階段狀態
使用下列其中一個值:
AdminModeEnabled
admin set-runtime-state 的選用引數
--async
-a
非同步執行 pac 動詞的可選布林引數,預設為 false。
此參數不需要任何值。 這是一個開關。
--background-operations
-bo
環境背景作業狀態
使用下列其中一個值:
EnabledDisabled
--max-async-wait-time
-wt
非同步等待時間上限(以分鐘為單位)。 預設值為 60 分鐘。
PAC 管理員狀態
此指令會列出所有進行中作業的狀態。
pac 管理員 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 概觀