Підтримка порталів для Microsoft Power Platform CLI
Microsoft Power Platform CLI (інтерфейс командного рядка) — це простий єдиний інтерфейс командного рядка для розробника, що дозволяє розробникам і авторам програм створювати компоненти коду.
Засоби CLI Microsoft Power Platform – це перший крок для повноцінного керування життєвим циклом програми (ALM), в межах якого розробники й постачальники програм можуть швидко та ефективно створювати, збирати, налагоджувати та публікувати розширення та настроювання. Додаткові відомості: Що таке Microsoft Power Platform CLI?
Завдяки цій функції портали Microsoft Power Apps підтримують Microsoft Power Platform CLI, що дозволяє використовувати CI/CD (безперервну інтеграцію/безперервне розгортання) конфігурації порталу. Тепер ви можете зареєструвати конфігурацію порталу у засобі контролю вихідного коду та перенести конфігурацію порталу до будь-якого середовища за допомогою Microsoft Power Platform CLI.
Примітка
Ця функція зазвичай доступна починаючи з Power Platform CLI версії 1.9.8. Щоб дізнатися про інсталяцію останньої версії, див. розділ Інсталяція Microsoft Power Platform CLI.
Навіщо використовувати Microsoft Power Platform CLI для розробки порталів?
Завдяки підтримці Microsoft Power Platform CLI ви можете використовувати близькі до автономних можливості настроювання порталів, вносячи зміни до вмісту порталів. А після збереження всіх настроювань або змін передавайте їх на портал. Під час завантаження вмісту порталів за допомогою Microsoft Power Platform CLI вміст структурується у форматах YAML і HTML, що дозволяє легко настроювати його і відкриває доступ до професійних можливостей розробки.
Нижче наведено список функцій і можливостей, які портал отримує завдяки підтримці Microsoft Power Platform CLI.
Простота використання
Підтримка завантаження/передавання даних порталу до/з локальної файлової системи
Розбудова на основі наявного засобу Microsoft Power Platform CLI.
Керування життєвим циклом програм (ALM)
Відстеження змін у конфігурації порталу в межах організації
Переміщення файлів конфігурації між організаціями або клієнтами
Підтримка засобів для професійних розробників та корпоративних засобів
Можливість простої інтеграції із засобами контролю вихідного коду, такими, як «git»
Легке налаштування процедур CI/CD
Вимоги
Перед використанням команд Microsoft Power Platform CLI для порталів переконайтеся, що на порталі увімкнуто підтримку цієї функції.
Інсталяція Microsoft Power Platform CLI
Покрокові інструкції див. в розділі Інсталяція Microsoft Power Platform CLI.
Таблиці, що підтримуються
Підтримка порталів для Microsoft Power Platform CLI обмежується таблицями, переліченими нижче.
adx_ad
adx_adplacement
adx_blog
adx_blogpost
adx_botconsumer
adx_communityforum
adx_communityforumaccesspermission
adx_contentsnippet
adx_entityform
adx_entityformmetadata
adx_entitylist
adx_entitypermission
adx_forumthreadtype
adx_pagetemplate
adx_poll
adx_polloption
adx_pollplacement
adx_portallanguage
adx_publishingstate
adx_redirect
adx_shortcut
adx_sitemarker
adx_sitesetting
adx_tag
adx_urlhistory
adx_webfile
adx_webform
adx_webformmetadata
adx_webformstep
adx_weblink
adx_weblinkset
adx_webpage
adx_webpageaccesscontrolrule
adx_webrole
adx_website
adx_websiteaccess
adx_websitebinding (тільки завантаження)
adx_websitelanguage
adx_webtemplate
Додавання зауважень
Важливо
Настроювані таблиці та таблиці, характерні для шаблонів порталів (наприклад, блоґ, спільнота або портал ідей) не підтримуються для настроювання за допомогою Microsoft Power Platform CLI.
Інсталяція та перевірка Microsoft Power Platform CLI для порталів
Щоб дізнатися про інсталяцію Microsoft Power Platform CLI, див. Інсталяція Microsoft Power Platform CLI.
Після інсталяції Microsoft Power Platform CLI відкрийте командний рядок і виконайте pac, щоб переконатись, що у виводі є «paportal» – команда для порталів Power Apps.

Команди Microsoft Power Platform CLI для порталів
Команда Microsoft Power Platform CLI для порталів — це paportal.
У розділах нижче наведено додаткові відомості про різні властивості команди paportal.
Параметри
| Ім'я властивості | Опис | Приклад |
|---|---|---|
| список | Виводить список усіх веб-сайтів порталів із поточного середовища Dataverse. | pac paportal list |
| завантаження | Завантажує вміст веб-сайту порталу з поточного середовища Dataverse. Має перелічені нижче параметри. - path: шлях, за яким буде завантажено вміст веб-сайту (псевдонім: -p) - webSiteId: ідентифікатор веб-сайту порталу для завантаження (псевдонім: -id) - overwrite: (необов'язково) значення true — перезаписати наявний вміст, значення false — перервати виконання, якщо у папці вже є вміст веб-сайту (псевдонім: -o) |
pac paportal download --path "C:\portals" --webSiteId f88b70cc-580b-4f1a-87c3-41debefeb902 |
| завантажити | Передає вміст веб-сайту порталу до поточного середовища Dataverse. Має зазначений нижче параметр. - path: шлях, за яким зберігається вміст веб-сайту (псевдонім: -p) -deploymentProfile: Завантажте дані порталу з деталями середовища, визначеними за допомогою змінних профілю в профілях розгортання / [ім’я профілю].deployment.yaml файл |
pac paportal upload --path "C:\portals\starter-portal" --deploymentProfile "profile-name" |
Використання профілю розгортання
Перемикач deploymentProfile дає змогу визначити набір змінних для середовища у форматі YAML. Наприклад, можна мати різні профілі розгортання (наприклад, для розробки, тестування, виробництва), які мають різні дані схеми, визначені в профілі.
Якщо ви створюєте тестовий профіль, можна створити файл у розділі deployment-profiles з іменем "test.deployment.yml" (а саме, <profileTag>.deployment.yml). І можна виконати команду з позначкою (<profileTag>), щоб використати цей профіль:
pac paportal upload --path "C:\portals\starter-portal" --deploymentProfile test
У цьому файлі можна мати ім’я таблиці (сутності) з ідентифікатором таблиці, списком атрибутів і значеннями, які потрібно змінити під час передавання конфігурації порталу за допомогою параметра deploymentProfile.
Крім того, можна використовувати змінну OS для доступу до змінних середовища операційної системи.
Нижче наведено приклад такого файлу YAML профілю "test.deployment.yml", який має унікальні дані схеми.
adx_sitesetting:
- adx_sitesettingid: 4ad86900-b5d7-43ac-1234-482529724970
adx_value: ${OS.FacebookAppId}
adx_name: Authentication/OpenAuth/Facebook/AppId
- adx_sitesettingid: 5ad86900-b5d7-43ac-8359-482529724979
adx_value: contoso_sample
adx_name: Authentication/OpenAuth/Facebook/Secret
adx_contentsnippet:
- adx_contentsnippetid: b0a1bc03-0df1-4688-86e8-c67b34476510
adx_name: PowerBI/contoso/sales
adx_value: https://powerbi.com/group/contoso/sales
Примітка
Щоб дізнатися про всі команди, що використовуються в CLI на додачу до порталів, перейдіть до розділу Загальні команди в Microsoft Power Platform CLI.
Файли маніфесту
Коли ви завантажуєте вміст веб-сайту за допомогою pac paportal download команди CLI, разом із завантаженням вмісту сайту він також генерує два файли маніфесту;
- Файл маніфесту середовища (org-url-manifest.yml)
- Видалити файл маніфесту відстеження (manifest.yml)
Файл маніфесту середовища (org-url-manifest.yml)
Файл маніфесту середовища генерується щоразу, pac paportal download коли виконується команда.
Після кожного завантаження інструмент PAC CLI зчитує наявний файл маніфесту середовища та оновлює записи, видалені в середовищі, або створює файл маніфесту середовища, якщо його не існує.
Коли ви запускаєте pac paportal upload команду для завантаження вмісту веб-сайту порталу. Він зчитує файл маніфесту середовища та ідентифікує зміни, внесені з моменту останнього завантаження, і завантажує лише оновлений вміст. Це допомагає оптимізувати процес завантаження, оскільки завантажується лише оновлений вміст веб-сайту, замість того, щоб завантажувати весь вміст у кожній команді завантаження.
Файл маніфесту середовища буде читатисятільки при підключенні до одного середовища (URL-адреса середовища збігається з ім’ям файлу), щоб уникнути випадкових змін.
Видалити файл маніфесту відстеження (manifest.yml)
Цей файл використовується для відстеження видалених записів з навколишнього середовища.
Коли вміст веб-сайту завантажується за допомогою pac paportal download команди, це додасть видалені записи з файлу маніфесту середовища (org-url-manifest.yml) до файлу manifest.yml. Отже, коли ви завантажуєте вміст веб-сайту за допомогою pac paportal upload команди, він видалить файли з середовища (навіть в інше середовище).
Цей файл не видаляється, і він використовується незалежно від того, яке середовище ви підключені.
Примітка
Для того, щоб видалити записи про вміст сайту в одному середовищі, а також видалити ті самі записи вмісту в іншому середовищі за допомогою PAC CLI, вам потрібно буде запустити pac paportal download команду до та після видалення вмісту запису веб-сайту. Manifest.yml буде відстежувати ці зміни і видаляти відповідні записи в цільовому середовищі при виконанні pac paportal upload команди.
Visual Studio Використовуйте розширення Code
Крім того, ви можете використовувати розширення VS Code Розширення Power Platform VS Code, щоб скористатися вбудованою мовою Liquid від IntelliSense, помічником з автозавершення коду й порадами, а також взаємодіяти із Microsoft Power Platform CLI, застосувавши вбудований термінал. Додаткові відомості: Використання розширення Visual Studio Code (підготовча версія)
Додаткові міркування
- Якщо ваш шлях виявиться довшим, ніж обмеження на найбільшу довжину шляху, буде повідомлено про помилку. Додаткові відомості: Максимальне обмеження довжини шляху в Windows
- Для повторюваних записів, наприклад, повторюваних імен веб-сторінок, Microsoft Power Platform CLI створює дві різні папки — одну із іменем веб-сторінки, а іншу – із тим же іменем, перед яким іде хеш-код. Наприклад, «My-page» та «My-page-хеш-код».
Наступні кроки
Посібник: використання Microsoft Power Platform CLI із порталами
Статті за темою
Зворотний зв’язок
Надіслати й переглянути відгук про