Självstudier: Använda Microsoft Power Platform CLI med portaler

I detta självstudieexempel lär du dig hur du kommer igång med Microsoft Power Platform CLI för att uppdatera exempelportalkonfigurationen.

Hämta och installera Visual Studio Code

För att ansluta till Power Apps-portaler och använda Microsoft Power Platform CLI-kommandon använder du Visual Studio Code samt den inbyggda terminalen. Den integrerade terminalen gör det enkelt att ansluta till Dataverse-miljön och att hämta, ändra och överföra portalkonfigurationen. Du kan också använda Windows PowerShell istället.

Steg 1. Autentisera

Innan du ansluter, listar, hämtar eller överför ändringar för en Power Apps-portal måste du först autentisera till Dataverse-miljön. Mer information om autentisering med Microsoft Power Platform CLI finns i pac auth.

Om du vill autentisera öppnar du Windows PowerShell och kör kommandot pac auth create med din Dataverse miljö-URL:

pac auth create -u [Dataverse URL]

Exempel

pac auth create -u https://contoso-org.crm.dynamics.com

Följ autentiseringsanvisningarna för att logga in på miljön.

Steg 2. Ange tillgängliga portaler

Använd pac paportal-listan för att lista de tillgängliga Power Apps-portalerna i den Dataverse-miljö anslöt till i föregående steg.

pac paportal list

Steg 3. Hämta portalinnehåll

Hämta portalwebbplatsinnehåll från den anslutna Dataverse-miljön med hjälp av kommandot pac paportal nedladdning.

pac paportal download --path [PATH] -id [WebSiteId-GUID]

Exempel

pac paportal download --path c:\pac-portals\downloads -id d44574f9-acc3-4ccc-8d8d-85cf5b7ad141

För parametern id använder du det WebSiteId som returnerades från utdatan från föregående steg.

Steg 4. Ändra portalinnehåll

Ändra konfigurationen med hjälp av Visual Studio Code och spara ändringarna.

På standardportalsidan visas till exempel följande text:

Den här texten visas från webbsidans html:

Du kan ändra den här texten och spara ändringarna:

Steg 5. Ladda upp ändringarna

När du har utfört erforderliga ändringar överför du dem med kommando pac paportal uppladdning:

pac paportal upload --path [Folder-location]

Exempel

pac paportal upload --path C:\pac-portals\downloads\custom-portal\

Överföringen sker bara för innehåll som har ändrats. I det här exemplet överförs innehållet endast till adx_webpage webbsida.

Ladda upp ändringarna med hjälp av distributionsprofil

När du arbetar med flera olika miljöer kanske du bör överväga att använda distributionsprofiler för att se till att ändringarna laddas upp till rätt miljö med hjälp av distributionsprofilen.

1. Skapa en mapp med namnet distributionsprofiler i mappen som innehåller portalinnehållet. Om det hämtade portalinnehållet till exempel finns i "startportalen" bör mappen med distributionsprofiler finnas i den här mappen.

   

2. I mappen med distributionsprofiler skapar du en YAML-fil som innehåller de miljöspecifika ändringarna. Utvecklingsmiljön kan till exempel kallas "dev.deployment.yml".

   

3. Redigera distributions-YAML-filen med Visual Studio Code med följande format:

   <table-name>:
   - <record-id>: <GUID>
     <column-name>: <Name>
     <column-value>: <Value>
   

   I följande exempelkod för YAML uppdateras till exempel värdet för "Suffix för webbläsartitel" från standard "Anpassad portal" till "Anpassad portal (dev)".

   adx_contentsnippet:
       - adx_contentsnippetid: 76227a41-a33c-4d63-b0f6-cd4ecd116bf8 # Replace with your content snippet ID
         adx_name: Browser Title Suffix # Setting name
         adx_value:   · Custom Portal (Dev) # Setting value
   

4. Om du vill ladda upp ändringarna till en annan miljö med hjälp av en YAML-fil för distributionsprofilen måste du först autentisera till målorganisationen.

5. När du har autentiserat och kopplat till rätt miljö använder du kommandot pac paportal uppladdning för att ladda upp innehållet:

   pac paportal upload --path "C:\portals\starter-portal" --deploymentProfile dev

   Anteckning

   I exemplet ovan används namnet på distributionsprofilen "dev" efter att ha följt föregående steg för att skapa en profil för utveckling av distributionen. Ändra namnet från "dev" till något annat (t.ex. QA för "qa.deployment.yml" eller Test för "test.deployment.yml") om du har använt ett annat filnamn för YAML-filen för distribution.

Steg 6. Bekräfta ändringarna

Så här bekräftar du ändringarna på portalens webbsida:

1. Rensa cachen på serversidan eller använd Synkronisera konfiguration med hjälp av Power Apps Portals Studio.

2. Bläddra till portalens webbsida för att se ändringen.

   

3. Om du tidigare har använt exempelprofilen för distribution som förklarats tidigare uppdaterar YAML-kodavsnittet värdet enligt vad som visas nedan.

   

   Suffix för webbläsartiteln som uppdateras genom ändringen ovan visar ändringen när du öppnar portalen i en webbläsare:

   

Detta avslutar självstudien. Du kan upprepa ovanstående steg och ändra portalinnehållet för andra tabeller som stöds.

Nästa steg

Använd Visual Studio Code tillägget

Se även

• Microsoft Power Platform CLI
• Använd tillägget för Visual Studio Code (förhandsversion)