Power Platform CLI

Wat is Power Platform CLI?

Microsoft Power Platform CLI is een opdrachtregeltool voor ontwikkelaars, beheerders en ISV's die met Power Platform werken. Het uitvoerbare commando heet pac.

De CLI bundelt commandogroepen voor authenticatie, omgevingen, Dataverse, solutions, Power Pages, connectors, codecomponenten en andere ontwikkeltaken. Welke commando's beschikbaar zijn, kan afhangen van versie, besturingssysteem en installatiemethode.

De tool is geschikt voor herhaalbare handelingen en pipelines. De makerportalen blijven nuttig voor interactief ontwerpen en visuele configuratie.

Installatie en versie

Microsoft biedt installatiemogelijkheden via een Visual Studio Code-extensie, een .NET-tool en op Windows een MSI. Niet iedere installatiemethode ondersteunt exact dezelfde commandogroepen.

Controleer de actieve versie met pac en raadpleeg hulp met pac help of pac solution help. Pin of registreer versies in buildomgevingen wanneer reproduceerbaarheid telt.

Release notes zijn relevant omdat commando's en parameters kunnen veranderen of als preview worden gemarkeerd.

Authenticatieprofielen

Veel commando's vereisen een verbinding met een tenant of omgeving. pac auth create maakt een lokaal profiel; pac auth list toont profielen en pac auth select kiest het actieve profiel.

pac auth create --name dev --environment https://contoso-dev.crm4.dynamics.com
pac auth list
pac auth select --name dev
pac org who

Controleer vóór een wijziging altijd tenant, omgeving en identiteit. Een verkeerd actief profiel kan een correct commando op de verkeerde omgeving uitvoeren.

Werken met solutions

De solutioncommandogroep ondersteunt onder meer export, import, pack, unpack en dependencycontroles. Unpack zet een solutionbestand om naar bestanden die beter in bronbeheer passen.

pac solution export --name Dossierbeheer --path ./out/Dossierbeheer.zip --managed false
pac solution unpack --zipfile ./out/Dossierbeheer.zip --folder ./src/Dossierbeheer

Pack en unpack maken wijzigingen niet automatisch conflictvrij. Complexe componenten zoals canvas apps en forms vragen een teamstrategie en zorgvuldige reviews.

PCF en ontwikkelwerk

PCF-projecten kunnen met pac pcf init worden gestart en aan een solutionproject worden toegevoegd. Andere commandogroepen ondersteunen Power Pages, connectors en Dataverse-data.

Gebruik de CLI-hulp van de geïnstalleerde versie als parameterreferentie. Kopieer geen verouderde voorbeelden blind naar scripts.

Gebruik in CI/CD

Een pipeline kan solutions bouwen, controleren en naar een doelomgeving uitrollen. Niet-interactieve authenticatie hoort een geschikte applicatie-identiteit te gebruiken in plaats van een persoonlijk profiel.

Bewaar secrets in de secret store van het CI/CD-platform en schrijf ze niet naar logs. Geef de identiteit alleen de rechten die voor de taak nodig zijn.

Maak scripts idempotent waar mogelijk en stop bij mislukte validaties. Een pipeline die fouten negeert levert geen betrouwbare deployment op.

CLI versus makerportal

De CLI is sterk in automatisering, bulkhandelingen en reproduceerbare workflows. Een portal is sterker voor visuele appbouw, inspectie en eenmalige configuratie.

Beide bedienen dezelfde platformartefacten. Een wijziging via de portal moet daarom nog steeds via de afgesproken solution- en bronbeheerroute worden vastgelegd.

Veilig dagelijks gebruik

Gebruik herkenbare profielnamen voor tenant en fase. Laat scripts de doelomgeving tonen en vereis een expliciete parameter voor productie.

Test destructieve of brede commando's eerst in een geïsoleerde omgeving. Exporteer of maak een back-up waar herstel dat vereist en controleer exitcodes in automatisering.

Noteer CLI-versie, parameters en uitvoer bij releases. Daarmee wordt een deployment herhaalbaar en is achteraf te onderzoeken welke artefacten werkelijk zijn toegepast.