KLONING AV POWER BI ARBEIDSOMRÅDE MED POWERSHELL
Du skal rulle ut en analyseløsning for et konsern. Du har opprettet datasett, rapporter og dashboards for ett av selskapene. Alt er testet og kunden er fornøyd. Nå gjenstår det bare å installere den samme løsningen for de andre selskapene i konsernet. Gjøres dette arbeidet manuelt må du opprette et nytt arbeidsområde, publisere alle datasettene, publisere alle rapportene, koble disse til riktig datasett, før du til slutt må bygge alle dashbords ved å feste hver enkelt av visualiseringene. Dette må da gjentas for alle selskapene. Prosjektleder vil anse dette er en kurrant sak. I realiteten er dette tidkrevende. Men fortvil ikke! Her er et PowerShell script som gjør alt arbeidet for deg :-)
|
Dokumentasjon: Kildeartikler:Kildefil:
|
STEG FOR STEG GJENNOMGANG AV SKRIPTET
Dette PowerShell skriptet inneholder alle kommandoene for å duplisere et komplett arbeidsområde med datasett, rapporter og dashboards. Hvis målarbeidsområdet ikke eksisterer vil skriptet opprette dette. Skriptet er delt inn i 4 steg:
La oss ta for oss hele skriptet, steg for steg, slik at vi får innsikt i hvilke operasjoner som utføres. Når du er klar for å kjøre skriptet finner du en komplett utlisting nederst på denne siden.
- Autentisere Power BI-brukeren ved å bruke Active Directory Authentication Library (ADAL).
- Eksportere PBIX-filer fra eksisterende arbeidsområde og importerer dem til nytt arbeidsområde.
- Kopiere gjenværende rapporter som er bygd på de samme datasettene som allerede er kopiert i trinn 2.
- Kopiere dashbords med fliser.
La oss ta for oss hele skriptet, steg for steg, slik at vi får innsikt i hvilke operasjoner som utføres. Når du er klar for å kjøre skriptet finner du en komplett utlisting nederst på denne siden.
PARAMETRE TIL SKRIPTET
Skriptet har 3 parametre som angir navnet på arbeidsområdene og hva som skjer dersom målarbeidsområdet ikke eksisterer.
- SourceWorkspaceName - navnet på arbeidsområdet du vil kopiere innholdet fra.
- TargetWorkspaceName - navnet på arbeidsområdet du vil kopiere til. Du må ha redigeringstilgang til det spesifiserte arbeidsområdet.
- CreateTargetWorkspaceIfNotExists - Et flagg som angir om skriptet skal opprette målarbeidsområdet hvis det ikke eksisterer. Standardverdien er å opprette målarbeidsområdet.
Code Editor
KJØRING AV SKRIPTET
Tast inn denne kommandoen i PowerSchell konsollet for å kjøre skriptet. Her vil innholdet i det eksisterende arbeidsområdet «Testområde» bli kopiert til et nytt arbeidsområde «Testklone».
Code Editor
STEG 1 - AUTENTISERE POWER BI-BRUKER
Dette skriptet bruker Power BI Management-modulen for Windows PowerShell. Hvis denne modulen ikke er installert vil skriptet automatisk installere denne. Hvis modulen er installert men ikke er riktig versjon vil skriptet oppgradere modulen.
Verifiseringen skjer ved at en hjelpefunksjon i skriptet kalles.
Verifiseringen skjer ved at en hjelpefunksjon i skriptet kalles.
Code Editor
Logger så inn på Power BI Services. Angi systembrukeren som er satt opp for å installere og administrere analyseløsningen.
Code Editor
STEG 2 - ARBEIDSOMRÅDE FOR KILDE OG MÅL
Gjenkjenner kildearbeidsområdet med navn angitt som parameteren. Hvis arbeidsområde finnes tar vi vare på ID-verdien til arbeidsområdet. Hvis ikke vil bruker få mulighet til å taste inn navnet i PowerShell konsollet.
Code Editor
Gjenkjenner målarbeidsområdet med navn angitt som parameteren. Hvis arbeidsområde finnes tar vi vare på ID-verdien til arbeidsområdet. Hvis ikke vil arbeidsområdet opprettes dersom ikke parameteren CreateTargetWorkspaceIfNotExists er satt til FALSE. Dersom du ikke har rettigheter for å opprette arbeidsområde vil skriptet avslutte med en feilmelding.
Code Editor
STEG 3 - EKSPORTER OG IMPORTER PBIX-FILER
Kopiering av rapporter og datasett via eksport / import av rapporter bygget på PBIXer (dette trinnet oppretter datasettene). Skriptet bruker to kartleggingstabeller for å holde ID-verdien til ny og gammel versjon av datasett og rapporter.
Code Editor
Oppretter en midlertidig mappe for å eksportere PBIX-filene.
Code Editor
Henter rapportene fra kildearbeidsområdet.
Code Editor
Eksporter PBIX-filene fra kilden, og importer dem deretter til målarbeidsområdet.
Code Editor
Kopier eventuelle andre rapporter som ikke er kopiert ennå.
Code Editor
STEG 4 - KOPIER INSTRUMENTBORD OG FLISER
Hent alle dashbord fra kildearbeidsområdet. Hvis kilden er «My Workspace, filtreres bort de dashbords som du ikke eier (f.eks. de som andre har delt med deg).
Code Editor
Kopier instrumentpaneler og fliser til målet arbeidsområde.
Code Editor
STEG 5 - OPPRYDDING
Sletter den midlertidige mappen som filer ble eksportert til.
Code Editor
KOMPLETT SCRIPT FOR KLONING AV ARBEIDSOMRÅDE
Dette PowerShell skriptet inneholder alle kommandoene for å duplisere et komplett arbeidsområde med datasett, rapporter og dashboards. Skriptet er delt inn i de følgende 4 seksjonene:
- Autentisere Power BI-brukeren ved å bruke Active Directory Authentication Library (ADAL).
- Eksportere PBIX-filer fra eksisterende arbeidsområde og importerer dem til nytt arbeidsområde.
- Kopiere gjenværende rapporter som er bygd på de samme datasettene som allerede er kopiert i trinn 2.
- Kopiere dashbords med fliser.
Code Editor