Hỗ trợ PowerShell cho Power Apps và Power Automate

Bài viết
08/06/2024

Với các lệnh ghép ngắn PowerShell dành cho người sáng tạo và quản trị viên, bạn có thể tự động hóa nhiều tác vụ giám sát và quản lý. Power Platform Các tác vụ chỉ có thể thực hiện thủ công ngày nay trong Power Apps, Power Automate hoặc Power Platform trung tâm quản trị.

Lệnh ghép ngắn

Cmdlet là các hàm được viết bằng ngôn ngữ lệnh PowerShell để thực thi các lệnh trong PowerShell. Chạy các lệnh Power Apps cmdlet này cho phép bạn tương tác với Nền tảng ứng dụng doanh nghiệp mà không cần phải thông qua cổng quản trị trong trình duyệt web.

Bạn có thể kết hợp lệnh ghép ngắn với các hàm PowerShell khác để viết các tập lệnh phức tạp giúp tối ưu hóa quy trình làm việc của bạn. Bạn vẫn có thể sử dụng lệnh ghép ngắn nếu bạn không phải là quản trị viên của đối tượng thuê, nhưng bạn bị giới hạn bởi các tài nguyên mà bạn sở hữu. Tài khoản người dùng quản trị sử dụng lệnh ghép ngắn bắt đầu bằng Admin.

Các lệnh ghép ngắn có sẵn trên thư viện PowerShell dưới dạng hai mô-đun riêng biệt:

Để biết thông tin về Power Apps mô-đun quản trị, hãy xem Bắt đầu sử dụng Power Apps mô-đun quản trị và Microsoft.PowerApps.Administration.PowerShell.

Bắt đầu với PowerShell

Nếu bạn mới sử dụng PowerShell và cần trợ giúp để tìm và khởi chạy PowerShell, hãy truy cập Bắt đầu sử dụng PowerShell. Nếu bạn cần trợ giúp về cách sử dụng PowerShell hoặc lệnh ghép ngắn, hãy truy cập Hệ thống trợ giúp PowerShell.

Điều kiện tiên quyết

PowerShell trong bài viết này yêu cầu Windows PowerShell phiên bản 5.x. Để kiểm tra phiên bản PowerShell đang chạy trên máy của bạn, hãy chạy lệnh sau:

$PSVersionTable.PSVersion

Nếu bạn có phiên bản cũ, hãy chuyển đến Nâng cấp Windows PowerShell hiện có.

Quan trọng

Các mô-đun được mô tả trong tài liệu này sử dụng .NET Framework, không tương thích với PowerShell 6.0 trở lên. Các phiên bản sau này sử dụng .NET Core.

Để chạy lệnh ghép ngắn PowerShell cho người tạo ứng dụng:

Chạy PowerShell với tư cách quản trị viên.

Nhập các mô-đun cần thiết.

Install-Module -Name Microsoft.PowerApps.Administration.PowerShell
Install-Module -Name Microsoft.PowerApps.PowerShell -AllowClobber

Ngoài ra, nếu bạn không có quyền quản trị trên máy tính, hãy sử dụng tham số -Scope CurrentUser để cài đặt.

Install-Module -Name Microsoft.PowerApps.Administration.PowerShell -Scope CurrentUser
Install-Module -Name Microsoft.PowerApps.PowerShell -AllowClobber -Scope CurrentUser

Nếu bạn được nhắc chấp nhận thay đổi đối với giá trị InstallationPolicy của kho lưu trữ, hãy chấp nhận [A] Yes cho tất cả các mô-đun bằng cách nhập A, sau đó nhấn Enter cho từng mô-đun.
Tùy chọn, bạn có thể cung cấp thông tin xác thực của mình trước khi truy cập lệnh. Thông tin đăng nhập sẽ được làm mới trong tối đa tám giờ trước khi bạn được yêu cầu đăng nhập lại. Nếu thông tin xác thực không được cung cấp trước khi lệnh được thực thi, thì lời nhắc nhập thông tin xác thực sẽ xuất hiện.
```
# Opens a prompt to collect credentials (Microsoft Entra account and password).
Add-PowerAppsAccount
```
```
# Here is how you can pass in credentials (to avoid opening a prompt).
$pass = ConvertTo-SecureString "password" -AsPlainText -Force
Add-PowerAppsAccount -Username user@contoso.com -Password $pass
```
Tùy chọn, có thể nhắm mục tiêu đến một điểm cuối cụ thể. Điểm cuối mặc định là prod. Nếu người dùng muốn chạy tập lệnh PowerShell nhắm mục tiêu đến môi trường trong vùng không phải vùng sản xuất, chẳng hạn như GCC, thì tham số -Endpoint có thể được thay đổi thành usgov cho GCC Moderate, hoặc usgovhigh cho GCC Highhoặc dod cho GCC DOD. Danh sách đầy đủ các điểm cuối được hỗ trợ là: "prod,bản xem trước,tip1,tip2,usgov,usgovhigh,dod,china".
```
# An environment in another region, such as GCC, can be targeted using the -Endpoint parameter.
Add-PowerAppsAccount -Endpoint "usgov" 
```

Cập nhật mô-đun

Bạn có thể kiểm tra phiên bản của tất cả các mô-đun PowerShell của mình bằng cách sử dụng Get-Module.

Get-Module

Và bạn có thể cập nhật tất cả các mô-đun PowerShell của mình lên phiên bản mới nhất bằng cách sử dụng Update-Module.

Update-Module

Ngoài ra, hãy kiểm tra phiên bản Power Platform modules bằng cách sử dụng Get-Module và tham số -Name .

Get-Module -Name "Microsoft.PowerApps.Administration.PowerShell"
Get-Module -Name "Microsoft.PowerApps.PowerShell"

Cập nhật các mô-đun Power Platform PowerShell bằng cách sử dụng Update-Module và tham số -Name .

Update-Module -Name "Microsoft.PowerApps.Administration.PowerShell"
Update-Module -Name "Microsoft.PowerApps.PowerShell"

Lệnh ghép ngắn Power Apps cho người tạo ứng dụng

Điều kiện tiên quyết

Người dùng có giấy phép hợp lệ có thể thực hiện các thao tác trong các lệnh ghép ngắn này. Power Apps Tuy nhiên, họ chỉ có quyền truy cập vào các tài nguyên như ứng dụng và luồng được tạo hoặc chia sẻ với họ.

Danh sách các lệnh ghép ngắn - Các lệnh ghép ngắn dành cho người tạo

Lưu ý

Chúng tôi đã cập nhật một số tên hàm cmdlet trong bản phát hành mới nhất để thêm tiền tố thích hợp nhằm tránh xung đột. Tham khảo bảng sau để biết tổng quan về những thay đổi.

Mục đích	Lệnh ghép ngắn
Thêm ứng dụng canvas vào giải pháp Microsoft Dataverse	Set-PowerAppAsSolutionAware
Đọc và cập nhật môi trường	Get-AdminPowerAppEnvironment(trước đây là Get-PowerAppsEnvironment) Get-FlowEnvironment Restore-PowerAppEnvironment(trước đây là Restore-AppVersion)
Đọc, cập nhật và xóa ứng dụng canvas	Get-AdminPowerApp(trước đây là Get-App) Remove-AdminPowerApp(trước đây là Remove-App) Publish-AdminPowerApp (trước đây là Publish-App)
Đọc, cập nhật và xóa các quyền của ứng dụng canvas	Get-AdminPowerAppRoleAssignment(trước đây là Get-AppRoleAssignment) Remove-AdminPowerAppRoleAssignment(trước đây là Remove-AppRoleAssignment)
Đọc, cập nhật và xóa luồng	Lấy-AdminFlow Bật-AdminFlow Tắt-AdminFlow Xóa-AdminFlow
Đọc, cập nhật và xóa các quyền của luồng	Nhận-AdminFlowOwnerRole Đặt-AdminFlowOwnerRole Xóa-AdminFlowOwnerRole
Đọc và trả lời phê duyệt luồng	Nhận-AdminFlowApprovalRequest Xóa-AdminFlowApprovals
Đọc và xóa kết nối	Get-AdminPowerAppConnection(trước đây là Get-Connection) Remove-AdminPowerAppConnection(trước đây là Remove-Connection)
Đọc, cập nhật và xóa các quyền kết nối	Get-AdminPowerAppConnectionRoleAssignment(trước đây là Get-ConnectionRoleAssignment) Set-AdminPowerAppConnectionRoleAssignment(trước đây là Set-ConnectionRoleAssignment) Remove-AdminPowerAppConnectionRoleAssignment(trước đây là Remove-ConnectionRoleAssignment)
Đọc và xóa bộ kết nối	Get-AdminPowerAppConnector(trước đây là Get-Connector) Remove-AdminPowerAppConnector(trước đây là Remove-Connector)
Thêm, đọc, cập nhật và xóa các quyền của bộ kết nối tùy chỉnh	Get-AdminPowerAppConnectorRoleAssignment(trước đây là Get-ConnectorRoleAssignment) Get-PowerAppConnectorRoleAssignment(trước đây là Set-ConnectorRoleAssignment) Remove-PowerAppConnectorRoleAssignment(trước đây là Remove-ConnectorRoleAssignment)
Đọc, thêm và xóa các mẫu URL chính sách	Lấy-PowerAppPolicyUrlPatterns Mẫu UrlPolicyPowerApp mới Xóa-PowerAppPolicyUrlPatterns
Đọc, đăng ký và xóa các ứng dụng quản lý	Nhận-PowerAppQuản lýỨng dụng Nhận-PowerAppQuản lýỨng dụng New-PowerAppQuản lýỨng dụng Xóa-PowerAppManagementApp
Đọc, tạo, cập nhật và nhập khóa bảo vệ	Nhận-PowerAppRetrieveAvailableTenantProtectionKeys Lấy-PowerAppGenerateProtectionKey Nhận-PowerAppRetrieveTenantProtectionKey Khóa bảo vệ nhập khẩu PowerApp mới Đặt-PowerAppTenantProtectionKey

Lệnh ghép ngắn Power Apps cho quản trị viên

Để biết thêm thông tin về Power Apps và Power Automate lệnh ghép ngắn dành cho quản trị viên, hãy xem Bắt đầu sử dụng PowerShell dành cho Power Platform Quản trị viên.

Mẹo

Sử dụng Get-Help theo sau là a CmdletName để có danh sách các ví dụ.
Sau khi bạn nhập dấu gạch ngang -, bạn có thể nhấn Tab để duyệt qua các thẻ nhập. Đặt cờ này sau tên lệnh cmdlet.

Lệnh ví dụ:

Get-Help Get-AdminPowerAppEnvironment
Get-Help Get-AdminPowerAppEnvironment -Examples
Get-Help Get-AdminPowerAppEnvironment -Detailed

Ví dụ hoạt động

Sau đây là một số tình huống phổ biến cho thấy cách sử dụng Power Apps cmdlet mới và hiện có.

Lệnh Môi trường
Power Apps Lệnh
Power Automate lệnh
Lệnh kết nối API
Các lệnh chính sách phòng ngừa mất dữ liệu (DLP)
Cmdlet miễn trừ tài nguyên DLP
Chặn lệnh cấp phép dùng thử

Các lệnh môi trường

Sử dụng các lệnh này để biết chi tiết và cập nhật môi trường trong đối tượng thuê của bạn.

Hiển thị danh sách tất cả các môi trường

Get-AdminPowerAppEnvironment

Trả về danh sách từng môi trường trên toàn bộ đối tượng thuê của bạn, kèm theo thông tin chi tiết về từng môi trường (ví dụ: tên môi trường (guid), tên hiển thị, vị trí, người tạo, v.v.).

Hiển thị chi tiết về môi trường mặc định của bạn

Get-AdminPowerAppEnvironment –Default

Trả về các chi tiết chỉ cho môi trường mặc định của đối tượng thuê.

Hiển thị chi tiết của một môi trường cụ thể

Get-AdminPowerAppEnvironment –EnvironmentName 'EnvironmentName'

Lưu ý

Trường EnvironmentName là một mã định danh duy nhất, khác với DisplayName (xem trường đầu tiên và trường thứ hai trong đầu ra ở hình ảnh sau).

Lệnh Get-AdminEnvironment.

Các lệnh trên Power Apps

Các hoạt động này được sử dụng để đọc và sửa đổi dữ liệu Power Apps trong đối tượng thuê của bạn.

Hiển thị danh sách tất cả các Power Apps

Get-AdminPowerApp

Trả về danh sách tất cả Power Apps trên toàn bộ đối tượng thuê, kèm theo thông tin chi tiết của từng đối tượng (ví dụ: tên ứng dụng (guid), tên hiển thị, người tạo, v.v.).

Hiển thị danh sách tất cả Power Apps khớp với tên hiển thị đầu vào

Get-AdminPowerApp 'DisplayName'

Lệnh này liệt kê tất cả Power Apps trong đối tượng thuê của bạn khớp với tên hiển thị.

Lưu ý

Sử dụng dấu ngoặc kép quanh các giá trị đầu vào có chứa khoảng trắng. Ví dụ, sử dụng "Tên ứng dụng của tôi".

Làm nổi bật ứng dụng

Set-AdminPowerAppAsFeatured –AppName 'AppName'

Các ứng dụng nổi bật được nhóm và đẩy lên đầu danh sách trong trình phát di động Power Apps.

Lưu ý

Giống như môi trường, trường AppName là một mã định danh duy nhất, khác với DisplayName. Nếu bạn muốn thực hiện các hoạt động dựa trên tên hiển thị, một số chức năng sẽ cho phép bạn sử dụng quy trình bán hàng (xem chức năng tiếp theo).

Biến ứng dụng thành ứng dụng chính, sử dụng quy trình bán hàng

Get-AdminPowerApp 'DisplayName' | Set-AdminPowerAppAsHero

ứng dụng nổi bật xuất hiện ở đầu danh sách trong trình phát di động. Power Apps Chỉ có thể có một ứng dụng chính.

Ký tự đường ống giữa hai lệnh cmdlet lấy đầu ra của lệnh cmdlet đầu tiên và truyền nó làm giá trị đầu vào của lệnh cmdlet thứ hai, nếu hàm được viết để phù hợp với đường ống. |

Lưu ý

Một ứng dụng phải là ứng dụng nổi bật trước khi được đổi thành ứng dụng Hero.

Hiển thị số lượng ứng dụng mà mỗi người dùng sở hữu

Get-AdminPowerApp | Select –ExpandProperty Owner | Select –ExpandProperty displayname | Group

Bạn có thể kết hợp các chức năng ban đầu của PowerShell với các lệnh ghép ngắn Power Apps để thao tác dữ liệu hơn nữa. Ở đây chúng tôi sử dụng hàm Chọn để tách biệt thuộc tính Chủ sở hữu (một đối tượng) khỏi đối tượng Get-AdminApp. Sau đó, chúng tôi cô lập tên của đối tượng chủ sở hữu bằng cách đặt đầu ra đó vào một chức năng Chọn khác. Cuối cùng, chuyển đầu ra hàm Chọn thứ hai vào hàm Nhóm sẽ trả về một bảng thích hợp chứa số lượng ứng dụng của mỗi chủ sở hữu.

Lệnh Get-AdminPowerApp.

Hiển thị số lượng ứng dụng trong mỗi môi trường

Get-AdminPowerApp | Select -ExpandProperty EnvironmentName | Group | %{ New-Object -TypeName PSObject -Property @{ DisplayName = (Get-AdminPowerAppEnvironment -EnvironmentName $_.Name | Select -ExpandProperty displayName); Count = $_.Count } }

Môi trường Get-AdminPowerApp.

Tải xuống chi tiết người dùng Power Apps

Get-AdminPowerAppsUserDetails -OutputFilePath '.\adminUserDetails.txt' –UserPrincipalName 'admin@bappartners.onmicrosoft.com'

Lệnh trên lưu trữ thông tin chi tiết của người dùng (thông tin sử dụng cơ bản về người dùng đầu vào thông qua tên người dùng chính của họ) trong tệp văn bản được chỉ định. Power Apps Lệnh này sẽ tạo một tệp mới nếu chưa có tệp nào có tên đó và ghi đè lên tệp văn bản nếu tệp đó đã tồn tại.

Xuất danh sách gồm các giấy phép người dùng đã chỉ định

Get-AdminPowerAppLicenses -OutputFilePath '<licenses.csv>'

Xuất tất cả giấy phép người dùng đã gán (Power Apps và Power Automate) trong đối tượng thuê của bạn vào tệp .csv dạng bảng. Tệp được xuất ra chứa cả các gói tự phục vụ, đăng ký, gói dùng thử nội bộ và các gói có nguồn gốc từ Microsoft Entra ID. Các gói dùng thử nội bộ không hiển thị với quản trị viên trong trung tâm quản trị Microsoft 365.

Khi đối tượng thuê có nhiều người dùng Microsoft Power Platform, quá trình xuất có thể mất chút thời gian.

Lưu ý

Đầu ra của lệnh ghép ngắn Get-AdminPowerAppLicenses chỉ bao gồm giấy phép cho người dùng đã truy cập dịch vụ Power Platform (ví dụ: Power Apps, Power Automate hoặc trung tâm quản trị Power Platform). Người dùng đã được cấp giấy phép trong Microsoft Entra ID (thường là thông qua Microsoft 365 trung tâm quản trị) nhưng chưa bao giờ truy cập Power Platform dịch vụ sẽ không có giấy phép của họ được bao gồm trong đầu ra .csv được tạo. Hơn nữa, vì dịch vụ cấp phép lưu trữ đệm các giấy phép nên các cập nhật được thực hiện đối với việc chỉ định giấy phép trong ID có thể mất tới bảy ngày để phản ánh trong đầu ra đối với những người dùng chưa truy cập dịch vụ gần đây. Power Platform Microsoft Entra

Đặt người dùng đã đăng nhập thành chủ sở hữu ứng dụng canvas

Set-AdminPowerAppOwner –AppName 'AppName' -AppOwner $Global:currentSession.userId –EnvironmentName 'EnvironmentName'

Thay đổi vai trò chủ sở hữu của Power App thành người dùng hiện tại và thay thế chủ sở hữu ban đầu thành loại vai trò "có thể xem".

Lưu ý

Các trường AppName và EnvironmentName là các mã định danh duy nhất (guid), không phải là tên hiển thị.

Hiển thị danh sách gồm các ứng dụng canvas trong một môi trường

Get-AdminDeletedPowerAppsList -EnvironmentName 'EnvironmentName'

Lệnh này hiển thị tất cả các ứng dụng canvas đã xóa gần đây vì chúng vẫn có thể được khôi phục.

Khôi phục ứng dụng canvas đã xóa

Get-AdminRecoverDeletedPowerApp -AppName 'AppName' -EnvironmentName 'EnvironmentName'

Lệnh này khôi phục ứng dụng canvas có thể phát hiện thông qua Get-AdminDeletedPowerAppsList cmdlet. Bất kỳ ứng dụng canvas nào không được hiển thị trong Get-AdminDeletedPowerAppsList đều không thể khôi phục được.

Chỉ định môi trường biểu mẫu tùy chỉnh SharePoint

Các lệnh ghép ngắn sau có thể được sử dụng để chỉ định và xác minh môi trường mà biểu mẫu tùy chỉnh SharePoint được lưu vào, thay vì môi trường mặc định. Khi môi trường được chỉ định cho SharePoint biểu mẫu tùy chỉnh thay đổi, môi trường này sẽ là nơi lưu các biểu mẫu tùy chỉnh mới tạo. Các biểu mẫu tùy chỉnh hiện tại không tự động di chuyển sang các môi trường khác nhau khi các lệnh ghép ngắn này được sử dụng. Khả năng người dùng tạo biểu mẫu tùy chỉnh trong môi trường được chỉ định yêu cầu người dùng đó phải có vai trò Người tạo môi trường. Người dùng có thể được cấp vai trò Người tạo môi trường trong trung tâm quản trị Power Platform.

Bất kỳ môi trường nào không phải là môi trường mặc định đều có thể bị xóa. Nếu môi trường biểu mẫu tùy chỉnh được chỉ định bị xóa, các biểu mẫu tùy chỉnh cũng bị xóa theo. SharePoint

Get-AdminPowerAppSharepointFormEnvironment

Lệnh này trả về EnvironmentName môi trường hiện được chỉ định cho các biểu mẫu tùy chỉnh mới được tạo. SharePoint Nếu một môi trường chưa bao giờ được chỉ định, môi trường mặc định sẽ được trả về.

Set-AdminPowerAppSharepointFormEnvironment –EnvironmentName 'EnvironmentName'

Lệnh này chỉ định môi trường lưu biểu mẫu tùy chỉnh mới được tạo SharePoint , thay vì môi trường mặc định. Các biểu mẫu tùy chỉnh hiện tại không tự động di chuyển sang môi trường mới được chỉ định. Chỉ có thể chỉ định môi trường sản xuất cho các biểu mẫu tùy chỉnh. SharePoint

Reset-AdminPowerAppSharepointFormEnvironment

Thao tác này sẽ đặt lại môi trường mặc định là môi trường được chỉ định để lưu biểu mẫu tùy chỉnh SharePoint.

$settings = Get-TenantSettings 
$settings.PowerPlatform.PowerApps.disableShareWithEveryone

Cài đặt này kiểm soát việc người dùng có người tạo trong môi trường vai trò bảo mật có thể chia sẻ ứng dụng canvas với Mọi người trong một tổ chức hay không. Khi cài đặt được đặt thành true, chỉ những người dùng có vai trò quản trị viên (quản trị viên Dynamics 365, Power Platform quản trị viên dịch vụ, Microsoft Entra quản trị viên đối tượng thuê) mới có thể chia sẻ ứng dụng với Mọi người trong một tổ chức.

Bất kể giá trị cài đặt đối tượng thuê bao này, người tạo có quyền chia sẻ có thể chia sẻ ứng dụng với các nhóm bảo mật có bất kỳ quy mô nào. Kiểm soát này chỉ xác định xem có thể sử dụng Mọi người viết tắt khi chia sẻ hay không.

$settings = Get-TenantSettings 
$settings.powerPlatform.powerApps.disableShareWithEveryone = $True 
Set-TenantSettings -RequestBody $settings

Hiển thị nội dung thông báo lỗi quản trị của tổ chức bạn

Nếu bạn chỉ định nội dung thông báo lỗi quản trị xuất hiện trong thông báo lỗi, nội dung trong thông báo lỗi sẽ được hiển thị khi người tạo ứng dụng nhận thấy họ không có quyền chia sẻ ứng dụng với Mọi người. Xem Các lệnh nội dung thông báo lỗi quản trị PowerShell.

Liên kết trong các dòng ngữ cảnh với một ứng dụng

Liên kết các dòng trong ngữ cảnh của một ứng dụng với ứng dụng đó để tạo sự phụ thuộc giữa ứng dụng và các dòng. Để tìm hiểu thêm về các dòng ngữ cảnh, hãy xem Những tính năng Power Automate nào được bao gồm trong giấy phép Power Apps?

   Add-AdminFlowPowerAppContext -EnvironmentName <String> -FlowName <String> -AppName <String> [-ApiVersion <String>] [<CommonParameters>]

EnvironmentName và FlowName có thể tìm thấy trong URL dòng:

Đối với luồng Không có Giải pháp, URL trông như thế này:

https://preview.flow.microsoft.com/manage/environments/839eace6-59ab-4243-97ec-a5b8fcc104e7/flows/6df8ec2d-3a2b-49ef-8e91-942b8be3202t/details

GUID sau environments/ là EnvironmentName và GUID sau flows/ là FlowName

Đối với Luồng giải pháp, URL trông như thế này:

https://us.flow.microsoft.com/manage/environments/66495a1d-e34e-e330-9baf-0be559e6900b/solutions/fd140aaf-4df4-11dd-bd17-0019b9312238/flows/53d829c4-a5db-4f9f-8ed8-4fb49da69ee1/details

GUID sau environments/ là EnvironmentName và GUID sau flows/ là FlowName

AppName cho ứng dụng canvas có thể được tìm thấy trên trang chi tiết ứng dụng canvas.
AppName cho ứng dụng dựa trên mô hình có thể được tìm thấy trong trình khám phá giải pháp.
Để xem ví dụ, hãy nhập: get-help Add-AdminFlowPowerAppContext -examples.
Để biết thêm thông tin, hãy nhập: get-help Add-AdminFlowPowerAppContext -detailed.
Để biết thông tin kỹ thuật, hãy nhập: get-help Add-AdminFlowPowerAppContext -full.

Xóa trong các dòng ngữ cảnh của một ứng dụng

Xóa biến phụ thuộc giữa các dòng và một ứng dụng bằng lệnh PowerShell này. Remove-AdminFlowPowerAppContex xóa ngữ cảnh ứng dụng khỏi dòng cụ thể.

    Remove-AdminFlowPowerAppContext -EnvironmentName <String> -FlowName <String> -AppName <String> [-ApiVersion <String>] [<CommonParameters>]

    - To see the examples, type: "get-help Remove-AdminFlowPowerAppContext -examples".
    - For more information, type: "get-help Remove-AdminFlowPowerAppContext -detailed".
    - For technical information, type: "get-help Remove-AdminFlowPowerAppContext -full".

Các lệnh trên Power Automate

Sử dụng các lệnh quan trọng này để thực hiện các thao tác quản trị liên quan đến Power Automate.

Để biết danh sách đầy đủ các Power Automate và Power Apps lệnh ghép ngắn dành cho quản trị viên, hãy xem Bắt đầu sử dụng PowerShell dành cho Power Platform Quản trị viên.

Hiển thị tất cả các luồng

Get-AdminFlow

Trả về một danh sách tất cả các luồng trong đối tượng thuê.

Hiển thị chi tiết vai trò chủ sở hữu luồng

Get-AdminFlowOwnerRole –EnvironmentName 'EnvironmentName' –FlowName 'FlowName'

Trả về chi tiết chủ sở hữu của luồng được chỉ định.

Lưu ý

Giống như Môi trường và PowerApps, FlowName là mã định danh duy nhất (guid), khác với tên hiển thị của luồng.

Hiển thị chi tiết người dùng luồng

Get-AdminFlowUserDetails –UserId $Global:currentSession.userId

Trả về các chi tiết người dùng liên quan đến việc sử dụng luồng. Trong ví dụ này, chúng tôi sử dụng ID người dùng của người dùng hiện đang đăng nhập vào phiên PowerShell làm đầu vào.

Xóa chi tiết người dùng luồng

Remove-AdminFlowUserDetails –UserId 'UserId'

Xóa hoàn toàn thông tin chi tiết về người dùng luồng khỏi cơ sở dữ liệu. Microsoft Tất cả các luồng mà người dùng đầu vào sở hữu phải bị xóa trước khi có thể xóa chi tiết người dùng luồng.

Lưu ý

Trường UserId là ID đối tượng của bản ghi Microsoft Entra của người dùng, có thể tìm thấy trong cổng thông tin Azure trong Microsoft Entra ID>Người dùng>Hồ sơ>ID đối tượng. Bạn phải là quản trị viên để truy cập dữ liệu này từ đây.

Xuất tất cả các luồng sang tệp CSV

Get-AdminFlow | Export-Csv -Path '.\FlowExport.csv'

Xuất tất cả các luồng trong đối tượng thuê của bạn vào tệp .csv dạng bảng.

Thêm luồng vào các giải pháp Dataverse

Add-AdminFlowsToSolution -EnvironmentName <String>

Di chuyển tất cả các dòng không chứa dung dịch trong môi trường.

Có thể sử dụng các biến thể tham số để chỉ di chuyển các luồng cụ thể, thêm vào một giải pháp cụ thể hoặc chỉ di chuyển một số lượng luồng nhất định tại một thời điểm.

Để biết thông tin chi tiết về kỹ thuật, hãy xem Add-AdminFlowsToSolution.

Các lệnh kết nối API

Xem và quản lý các kết nối API trong đối tượng thuê của bạn.

Hiển thị tất cả các Kết nối ban đầu trong môi trường mặc định của bạn

Get-AdminPowerAppEnvironment -Default | Get-AdminPowerAppConnection

Hiển thị danh sách tất cả các kết nối API bạn có trong môi trường mặc định. Kết nối ban đầu được tìm thấy trong thẻ Dataverse>Kết nối trong Power Apps.

Hiển thị tất cả các kết nối tùy chỉnh trong đối tượng thuê

Get-AdminPowerAppConnector

Trả về một danh sách tất cả các chi tiết bộ kết nối tùy chỉnh trong đối tượng thuê.

Lưu ý

Get-AdminPowerAppConnector không liệt kê các trình kết nối tùy chỉnh có trong giải pháp. Đây là hạn chế đã ghi nhận.

Các lệnh của chính sách Ngăn ngừa mất dữ liệu (DLP)

Các lệnh ghép ngắn này kiểm soát các chính sách DLP trên đối tượng thuê của bạn.

Tạo chính sách DLP

New-DlpPolicy

Tạo chính sách DLP mới cho đối tượng thuê của quản trị viên đã đăng nhập.

Lấy danh sách các đối tượng DLP

Get-DlpPolicy

Nhận đối tượng chính sách cho đối tượng thuê của quản trị viên đã đăng nhập.

Lưu ý

Khi xem chính sách DLP bằng PowerShell, tên hiển thị của các đầu nối sẽ được lấy từ thời điểm chính sách DLP được tạo hoặc thời điểm các đầu nối được di chuyển lần cuối trong chính sách. Những thay đổi mới về tên hiển thị của trình kết nối sẽ không được phản ánh.
Khi xem chính sách DLP bằng PowerShell, các kết nối mới trong nhóm mặc định chưa được di chuyển sẽ không được trả về.

Đối với cả hai sự cố đã biết này, giải pháp khắc phục là di chuyển trình kết nối bị ảnh hưởng sang nhóm khác trong chính sách, sau đó di chuyển lại về nhóm chính xác. Sau khi thực hiện xong, mỗi đầu nối sẽ hiển thị với tên chính xác của chúng.

Cập nhật chính sách DLP

Set-DlpPolicy

Cập nhật chi tiết của chính sách, chẳng hạn như tên hiển thị chính sách.

Loại bỏ chính sách

Remove-DlpPolicy

Xóa chính sách DLP.

Các lệnh ghép ngắn miễn trừ nguồn lực DLP

Các lệnh ghép ngắn này cho phép bạn miễn hoặc loại bỏ một nguồn lực cụ thể khỏi chính sách DLP.

Truy xuất danh sách nguồn lực được miễn hiện có cho chính sách DLP

Get-PowerAppDlpPolicyExemptResources -TenantId -PolicyName

Tạo danh sách nguồn lực được miễn mới cho chính sách DLP

New-PowerAppDlpPolicyExemptResources -TenantId -PolicyName -NewDlpPolicyExemptResources

Cập nhật danh sách nguồn lực được miễn cho chính sách DLP

Set-PowerAppDlpPolicyExemptResources -TenantId -PolicyName -UpdatedExemptResources

Loại bỏ danh sách nguồn lực được miễn cho chính sách DLP

Remove-PowerAppDlpPolicyExemptResources -TenantId -PolicyName

Để miễn trừ một tài nguyên khỏi chính sách DLP, bạn cần những thông tin sau:

ID đối tượng thuê (GUID)
ID chính sách DLP (GUID)
ID nguồn lực (kết thúc bằng GUID)
Loại tài nguyên

Bạn có thể truy xuất ID nguồn lực và nhập bằng cách sử dụng lệnh ghép ngắn PowerShell Get-PowerApp cho ứng dụng và Get-Flow cho các luồng.

Ví dụ về tập lệnh xóa

Để miễn trừ luồng có ID f239652e-dd38-4826-a1de-90a2aea584d9 và ứng dụng có ID 06002625-7154-4417-996e-21d7a60ad624, chúng ta có thể chạy các lệnh ghép ngắn sau:

1. PS D:\> $flow = Get-Flow -FlowName f239652e-dd38-4826-a1de-90a2aea584d9 
2. PS D:\> $app = Get-PowerApp -AppName 06002625-7154-4417-996e-21d7a60ad624 
3. PS D:\> $exemptFlow = [pscustomobject]@{ 
4. >>             id = $flow.Internal.id 
5. >>             type = $flow.Internal.type 
6. >>         } 
7. PS D:\> $exemptApp = [pscustomobject]@{ 
8. >>             id = $app.Internal.id 
9. >>             type = $app.Internal.type 
10. >>         } 
11. PS D:\> $exemptResources = [pscustomobject]@{ 
12. >>             exemptResources = @($exemptFlow, $exemptApp) 
13. >>         } 
14. PS D:\> New-PowerAppDlpPolicyExemptResources -TenantId b1c07da8-2ae2-47e7-91b8-d3418892f507 -PolicyName 65da474a-70aa-4a59-9ae1-65a2bebbf98a -NewDlpPolicyExemptResources $exemptResources 
15. 
16. exemptResources 
17. --------------- 
18. {@{id=/providers/Microsoft.ProcessSimple/environments/Default-b1c07da8-2ae2-47e7-91b8-d3418892f507/flows/f239652e-dd38-4826-a1de-90a2aea584d9; type=Microsoft.ProcessSimple/environments/flows}, @{id=/providers/Microsoft.PowerApps/apps/06002625-7154-4417-996e-21d7a60ad..

Kinh nghiệm miễn trừ DLP trong các trường hợp sau

#	Kịch bản	Trải nghiệm
1	Người dùng khởi chạy một ứng dụng không tuân thủ DLP nhưng được miễn DLP.	Quá trình khởi chạy ứng dụng tiến hành có hoặc không có thực thi DLP.
2	Người tạo lưu một ứng dụng không tuân thủ DLP nhưng được miễn DLP	Có hoặc không có miễn trừ DLP, việc tuân thủ DLP sẽ không chặn hoạt động lưu ứng dụng. Cảnh báo không tuân thủ DLP sẽ được hiển thị bất kể có miễn trừ DLP hay không.
3	Người tạo lưu một dòng không tuân thủ DLP nhưng được miễn DLP	Có hoặc không có miễn trừ DLP, việc tuân thủ DLP không chặn hoạt động lưu luồng. Cảnh báo không tuân thủ DLP không xuất hiện.

Các lệnh nội dung thông báo lỗi quản trị

Các lệnh ghép ngắn sau đây có thể dẫn người dùng cuối đến tài liệu tham khảo về quản trị của tổ chức bạn. Lệnh này bao gồm liên kết để ghi chép tài liệu quản trị và thông tin liên hệ quản trị khi được nhắc nhở bởi các biện pháp kiểm soát quản trị. Ví dụ, khi nội dung thông báo lỗi quản trị được đặt, nó sẽ xuất hiện trong Power Apps các thông báo thực thi thời gian chạy chính sách Phòng ngừa mất dữ liệu.

Đặt nội dung thông báo lỗi quản trị

New-PowerAppDlpErrorSettings -TenantId 'TenantId' -ErrorSettings @{  
  ErrorMessageDetails = @{ 
    enabled = $True  
    url = "https://contoso.org/governanceMaterial" 
  } 
  ContactDetails= @{  
    enabled = $True 
    email = "admin@contoso.com" 
  } 
}

URL và email thông báo lỗi quản trị có thể được hiển thị độc lập hoặc cùng nhau. Bạn có thể bật hoặc tắt thông báo lỗi quản trị bằng trường enabled .

Kịch bản nội dung thông báo lỗi quản trị

#	Kịch bản	Trạng thái rảnh/bận
1	Người dùng khởi chạy một ứng dụng được tạo bằng Power Apps không tuân thủ DLP	Có sẵn công khai
2	Nhà sản xuất chia sẻ một ứng dụng canvas Power Apps nhưng không có đặc quyền chia sẻ	Có sẵn công khai
3	Maker chia sẻ một ứng dụng Power Apps canvas với Mọi người nhưng không có quyền chia sẻ với Mọi người	Có sẵn công khai
Tệp 4	Người tạo lưu một ứng dụng được tạo bằng Power Apps không tuân thủ DLP	Có sẵn công khai
5	Người tạo lưu một dòng Power Automate không tuân thủ DLP	Có sẵn công khai
6	Người dùng khởi chạy ứng dụng mà không có tư cách thành viên nhóm bảo mật với nhóm bảo mật được liên kết với Dataverse môi trường	Có sẵn công khai

Hiển thị nội dung thông báo lỗi quản trị

Get-PowerAppDlpErrorSettings -TenantId 'TenantId'

Cập nhật nội dung thông báo lỗi quản trị

Set-PowerAppDlpErrorSettings -TenantId 'TenantId' -ErrorSettings @{  
  ErrorMessageDetails = @{ 
    enabled = $True  
    url = "https://contoso.org/governanceMaterial" 
  } 
  ContactDetails= @{  
    enabled = $True 
    email = "admin@contoso.com" 
  } 
}

Thực thi chính sách DLP đối với các kết nối vi phạm - môi trường

Các lệnh ghép ngắn này cho phép bạn thực thi chính sách DLP đối với các kết nối vi phạm ở cấp độ môi trường hoặc đối tượng thuê.

Thực thi chính sách DLP đối với các kết nối vi phạm

Bạn có thể áp dụng chính sách DLP cho các kết nối trong môi trường. Việc thực thi sẽ vô hiệu hóa các kết nối hiện có vi phạm chính sách DLP và kích hoạt mọi kết nối đã bị vô hiệu hóa trước đó không còn vi phạm chính sách DLP.

Start-DLPEnforcementOnConnectionsInEnvironment -EnvironmentName [Environment ID]

Ví dụ về tập lệnh thực thi môi trường

Start-DLPEnforcementOnConnectionsInEnvironment -EnvironmentName c4a07cd6-cb14-e987-b5a2-a1dd61346963

Thực thi chính sách DLP đối với các kết nối vi phạm - người thuê nhà

Bạn có thể áp dụng chính sách DLP trên các kết nối trong đối tượng thuê. Việc thực thi sẽ vô hiệu hóa các kết nối hiện có vi phạm chính sách DLP và kích hoạt mọi kết nối đã bị vô hiệu hóa trước đó không còn vi phạm chính sách DLP.

Start-DLPEnforcementOnConnectionsInTenant

Chặn lệnh giấy phép dùng thử

Lệnh:

Remove-AllowedConsentPlans
Add-AllowedConsentPlans
Get-AllowedConsentPlans

Các lệnh ghép ngắn của gói đồng ý được cho phép có thể được sử dụng để thêm hoặc loại bỏ quyền truy cập vào một loại gói đồng ý cụ thể từ đối tượng thuê. Kế hoạch chấp thuận "nội bộ" là giấy phép dùng thử hoặc kế hoạch nhà phát triển mà người dùng có thể tự đăng ký qua các cổng thông tin/Power Automate Power Apps/Power Automate dành cho máy tính để bàn. Các gói "Đăng ký theo yêu cầu" hoặc "Viral" là các giấy phép dùng thử mà người dùng có thể tự đăng ký tại https://signup.microsoft.com. Quản trị viên có thể chỉ định người dùng thông qua Microsoft Entra ID hoặc Microsoft 365 cổng thông tin quản trị.

Theo mặc định, tất cả các loại gói đồng ý được cho phép trong một đối tượng thuê. Tuy nhiên, Power Platform quản trị viên có thể muốn chặn người dùng tự cấp giấy phép dùng thử nhưng vẫn giữ quyền cấp giấy phép dùng thử thay mặt cho người dùng. Quy tắc này có thể được thực hiện bằng cách sử dụng lệnh Remove-AllowedConsentPlans -Types "Internal" và vô hiệu hóa cài đặt AllowAdHocSubscriptions trong Microsoft Entra ID.

Quan trọng

Khi sử dụng Remove-AllowedConsentPlans, tất cả các gói hiện có của loại được chỉ định sẽ bị xóa khỏi tất cả người dùng trong đối tượng thuê và không thể khôi phục được. Lệnh này chặn mọi lệnh tương tự trong tương lai. Nếu Power Platform người quản trị muốn kích hoạt lại các gói loại đó, họ có thể sử dụng Add-AllowedConsentPlans. Nếu họ muốn xem trạng thái hiện tại của các kế hoạch chấp thuận được phép, họ có thể sử dụng Get-AllowedConsentPlans.

Nếu bạn có thắc mắc

Nếu bạn có bất kỳ nhận xét, đề xuất hoặc câu hỏi nào, hãy đăng chúng lên Quản trị bảng cộng đồng Power Apps.

Xem thêm

Bắt đầu sử dụng mô-đun quản trị. Power Apps
Microsoft.PowerApps.Quản trị.PowerShell
bản xem trước: Tổng quan về khả năng lập trình và khả năng mở rộng

Chia sẻ qua

Hỗ trợ PowerShell cho Power Apps và Power Automate

Lệnh ghép ngắn

Bắt đầu với PowerShell

Điều kiện tiên quyết

Cài đặt mô-đun và đăng nhập

Cập nhật mô-đun

Lệnh ghép ngắn Power Apps cho người tạo ứng dụng

Điều kiện tiên quyết

Danh sách các lệnh ghép ngắn - Các lệnh ghép ngắn dành cho người tạo

Lệnh ghép ngắn Power Apps cho quản trị viên

Mẹo

Ví dụ hoạt động

Các lệnh môi trường

Hiển thị danh sách tất cả các môi trường

Hiển thị chi tiết về môi trường mặc định của bạn

Hiển thị chi tiết của một môi trường cụ thể

Các lệnh trên Power Apps

Hiển thị danh sách tất cả các Power Apps

Hiển thị danh sách tất cả Power Apps khớp với tên hiển thị đầu vào

Làm nổi bật ứng dụng

Biến ứng dụng thành ứng dụng chính, sử dụng quy trình bán hàng

Hiển thị số lượng ứng dụng mà mỗi người dùng sở hữu

Hiển thị số lượng ứng dụng trong mỗi môi trường

Tải xuống chi tiết người dùng Power Apps

Xuất danh sách gồm các giấy phép người dùng đã chỉ định

Đặt người dùng đã đăng nhập thành chủ sở hữu ứng dụng canvas

Hiển thị danh sách gồm các ứng dụng canvas trong một môi trường

Khôi phục ứng dụng canvas đã xóa

Chỉ định môi trường biểu mẫu tùy chỉnh SharePoint

Hiển thị cài đặt người thuê để có thể chia sẻ ứng dụng với Mọi người

Thay đổi cài đặt người thuê để có thể chia sẻ ứng dụng với Mọi người

Hiển thị nội dung thông báo lỗi quản trị của tổ chức bạn

Liên kết trong các dòng ngữ cảnh với một ứng dụng

Xóa trong các dòng ngữ cảnh của một ứng dụng

Các lệnh trên Power Automate

Hiển thị tất cả các luồng

Hiển thị chi tiết vai trò chủ sở hữu luồng

Hiển thị chi tiết người dùng luồng

Xóa chi tiết người dùng luồng

Xuất tất cả các luồng sang tệp CSV

Thêm luồng vào các giải pháp Dataverse

Các lệnh kết nối API

Hiển thị tất cả các Kết nối ban đầu trong môi trường mặc định của bạn

Hiển thị tất cả các kết nối tùy chỉnh trong đối tượng thuê

Các lệnh của chính sách Ngăn ngừa mất dữ liệu (DLP)

Tạo chính sách DLP

Lấy danh sách các đối tượng DLP

Cập nhật chính sách DLP

Loại bỏ chính sách

Các lệnh ghép ngắn miễn trừ nguồn lực DLP

Truy xuất danh sách nguồn lực được miễn hiện có cho chính sách DLP

Tạo danh sách nguồn lực được miễn mới cho chính sách DLP

Cập nhật danh sách nguồn lực được miễn cho chính sách DLP

Loại bỏ danh sách nguồn lực được miễn cho chính sách DLP

Ví dụ về tập lệnh xóa

Kinh nghiệm miễn trừ DLP trong các trường hợp sau

Các lệnh nội dung thông báo lỗi quản trị

Đặt nội dung thông báo lỗi quản trị

Kịch bản nội dung thông báo lỗi quản trị

Hiển thị nội dung thông báo lỗi quản trị

Cập nhật nội dung thông báo lỗi quản trị

Thực thi chính sách DLP đối với các kết nối vi phạm - môi trường

Thực thi chính sách DLP đối với các kết nối vi phạm

Ví dụ về tập lệnh thực thi môi trường

Thực thi chính sách DLP đối với các kết nối vi phạm - người thuê nhà

Chặn lệnh giấy phép dùng thử

Nếu bạn có thắc mắc

Xem thêm

Phản hồi

Tài nguyên bổ sung