Copilot Managed Runtime CLI-kommandoreference (prøveversion)

[Denne artikel er foreløbig dokumentation og kan ændres uden varsel.]

Copilot Managed Runtime CLI er publiceret som @microsoft/managed-apps-cli og aktiveret som ms.

De fleste kommandoer fungerer på appen i den aktuelle mappe og læser standardindstillinger fra dens lokale konfiguration (appnavn, miljø, lagerbinding). Kør kommandoer fra den mappe, der indeholder din app, medmindre et flag udtrykkeligt giver dig mulighed for at målrette mod en anden app.

Denne reference grupperer alle kommandoer efter typiske arbejdsprocesopgaver for udviklere:

Gruppe Kommando Beskrivelse
Godkendelse ms auth login Log på Microsoft Entra ID via browseren.
Godkendelse ms auth logout Ryd cachelagrede legitimationsoplysninger, og fjern den aktive kontomarkør.
Godkendelse ms auth status Angiv cachelagrede konti, og angiv den aktive.
Godkendelse ms auth switch Aktivér en anden cachelagret konto.
Godkendelse ms git auth refresh Opdater eller opret Entra-til-GitHub-identitetstilknytningen.
Opret en app ms app create Opret en ny app, og stillads en projektskabelon.
Opret en app ms app clone Klon en eksisterende apps platformsadministrerede Git-lager.
Opret en app ms app init Registrere et eksisterende webprojekt som en app.
Find forbindelser ms connector list Liste over forbindelser, der er tilgængelige i et miljø.
Find forbindelser ms connector list-actions Angiv handlinger, der eksponeres af en forbindelse.
Administrer appressourcer ms app add data-source Føj en forbindelse til appen som en tabel eller handlingsdatakilde.
Administrer appressourcer ms app remove data-source Fjerne en tidligere tilføjet datakilde (tabel eller handling) fra appen.
Administrer appressourcer ms app refresh data-source Genhent skema, og gendan TypeScript for bundne datakilder.
Udvikl lokalt ms app dev Start det fulde lokale udviklingskredsløb.
Byg og installer ms app pack Byg appen lokalt, og klargør output til inspektion.
Byg og installer ms app build Udløs et platformsbuild for en bestemt bekræftelse.
Byg og installer ms app build-status Kontrollér status for et build.
Byg og installer ms app deploy Fremhæv et grønt build til liveappen.
Afspil ms app play Åbn en app, og udskriv start-URL-adressen.
Del ms app share Giv adgang til brugere eller grupper.
Del ms app share list Angiv de brugere og grupper, en app deles med.
Del ms app unshare Tilbagekalde tidligere tildelt adgang.
Del ms app share link create Opret et delingslink for hele lejeren til appen.
Del ms app share link list Listedelingslinks, der er udstedt til appen.
Del ms app share link revoke Tilbagekald et delingslink efter id.
Undersøg og administrer ms app list Vis apps i det miljø, som du kan få adgang til.
Undersøg og administrer ms app show Vis lokal konfiguration og bundne ressourcer.
Undersøg og administrer ms app info Vise appens serversidetilstand.
Undersøg og administrer ms app get-settings Vise alle appindstillinger og deres aktuelle værdier.
Undersøg og administrer ms app set-setting Opdater én eller flere appindstillinger.
Undersøg og administrer ms app delete Slet appen fra miljøet.
Telemetri ms telemetry enable Slå indsamling af telemetri til.
Telemetri ms telemetry disable Slå indsamling af telemetri fra.
Telemetri ms telemetry status Vise aktuelle indstillinger for telemetri.

Kommandoindeks

I følgende tabel vises kommandoerne alfabetisk:

Kommando Gruppe Beskrivelse
ms app add data-source Administrer appressourcer Føj en forbindelse til appen som en tabel eller handlingsdatakilde.
ms app build Byg og installer Udløs et platformsbuild for en bestemt bekræftelse.
ms app build-status Byg og installer Kontrollér status for et build.
ms app clone Opret en app Klon en eksisterende apps platformsadministrerede Git-lager.
ms app create Opret en app Opret en ny app, og stillads en projektskabelon.
ms app delete Undersøg og administrer Slet appen fra miljøet.
ms app deploy Byg og installer Fremhæv et grønt build til liveappen.
ms app dev Udvikl lokalt Start det fulde lokale udviklingskredsløb.
ms app get-settings Undersøg og administrer Vise alle appindstillinger og deres aktuelle værdier.
ms app info Undersøg og administrer Vise appens serversidetilstand.
ms app init Opret en app Registrere et eksisterende webprojekt som en app.
ms app list Undersøg og administrer Vis apps i det miljø, som du kan få adgang til.
ms app pack Byg og installer Byg appen lokalt, og klargør output til inspektion.
ms app play Afspil Åbn en app, og udskriv start-URL-adressen.
ms app refresh data-source Administrer appressourcer Genhent skema, og gendan TypeScript for bundne datakilder.
ms app remove data-source Administrer appressourcer Fjerne en tidligere tilføjet datakilde (tabel eller handling) fra appen.
ms app set-setting Undersøg og administrer Opdater én eller flere appindstillinger.
ms app share Del Giv adgang til brugere eller grupper.
ms app share list Del Angiv de brugere og grupper, en app deles med.
ms app share link create Del Opret et delingslink for hele lejeren til appen.
ms app share link list Del Listedelingslinks, der er udstedt til appen.
ms app share link revoke Del Tilbagekald et delingslink efter id.
ms app show Undersøg og administrer Vis lokal konfiguration og bundne ressourcer.
ms app unshare Del Tilbagekalde tidligere tildelt adgang.
ms auth login Godkendelse Log på Microsoft Entra ID via browseren.
ms auth logout Godkendelse Ryd cachelagrede legitimationsoplysninger, og fjern den aktive kontomarkør.
ms auth status Godkendelse Angiv cachelagrede konti, og angiv den aktive.
ms auth switch Godkendelse Aktivér en anden cachelagret konto.
ms connector list Find forbindelser Liste over forbindelser, der er tilgængelige i et miljø.
ms connector list-actions Find forbindelser Angiv handlinger, der eksponeres af en forbindelse.
ms git auth refresh Godkendelse Opdater eller opret Entra-til-GitHub-identitetstilknytningen.
ms telemetry disable Telemetri Slå indsamling af telemetri fra.
ms telemetry enable Telemetri Slå indsamling af telemetri til.
ms telemetry status Telemetri Vise aktuelle indstillinger for telemetri.

Globale flag

Hver kommando accepterer følgende flag.

Flag Alias Påkrævet? Beskrivelse
--json Nej Få vist resultatet som et enkelt JSON-objekt (eller NDJSON til streamingkommandoer). Brug dette i scripts og CI.
--non-interactive Nej Kør uden prompter. Alle påkrævede værdier skal leveres via flag eller miljøvariabler. Brug dette i scripts og CI.
--no-color Nej Deaktiver farvet output.
--cloud <cloud> Nej Skymiljø at målrette mod. Gyldige værdier er public (standard), usgov, usgovhigh, usgovdodog china.
--version -v Nej Udskriv CLI-versionen.
--help -h Nej Vis hjælp til kommandoen, herunder alle tilgængelige flag.

Tip

Kør ms uden argumenter for grupperet hjælp på øverste niveau, ms app for appunderkommandoer og ms app <verb> --help for et verbums flag. Funktionerne kommer gradvist til overfladen, mens du går ind i detaljer.

Godkendelse

Log på én gang pr. maskine. Alle andre kommandoer forudsætter en godkendt session mod en Copilot Managed Runtime-aktiveret lejer.

ms auth login

Log på Microsoft Entra ID via browseren. Føjer den nye konto til cachen og gør den aktiv.

ms auth login [--account <email>]

ms auth login account parameter

Forsøger at logge dig på som den valgte konto. Dette er nyttigt i scenarier med flere konti. Du kan vælge mellem konti, der allerede er cachelagret, ved at bruge ms auth switch i stedet.

ms auth logout

Ryd alle cachelagrede legitimationsoplysninger, og fjern markøren for den aktive konto.

ms auth logout

Hvis du vil ændre, hvilken konto der er aktiv uden at logge af, skal du bruge ms auth switch.

ms auth status

Angive cachelagrede konti. Når mere end én konto er cachelagret, markeres den aktive konto (den, der bruges af andre kommandoer) med *.

ms auth status

ms auth switch

Gøre en anden cachelagret konto aktiv for efterfølgende kommandoer.

ms auth switch [--account <email>]

ms auth switch account parameter

Den konto, der skal aktiveres. I interaktiv tilstand med flere cachelagrede konti beder CLI om at vælge, hvis dette flag udelades. Påkrævet i ikke-interaktiv tilstand, og når du bruger --json.

Git-godkendelse

Nogle kommandoer skal bekræfte, at din Microsoft Entra-identitet er knyttet til en GitHub-bruger med adgang til det bundne lager. Første gang der kræves en tilknytning, ms app create, ms app build, og ms app deploy kør GitHub-enhedskodeflowet indbygget – du behøver ikke at opdatere proaktivt for at kunne konfigurere den første gang. Bruges ms git auth refresh til at gengodkende eksplicit (f.eks. når du skifter GitHub-konti).

ms git auth refresh

Opdater eller etabler Microsoft Entra ↔ GitHub-identitetstilknytningen for et lager, der ejes af en GitHub Enterprise Cloud-organisation.

ms git auth refresh --repo <url> [--open-browser]

Kommandoen udskriver bekræftelses-URL-adressen og en brugerkode, som du kan indsætte i en browser. Når det lykkes, udskrives det godkendte GitHub-logon og tilknytningens udløbstidsstempel. Tryk Ctrl+C for at annullere polling-løkken rent.

ms git auth refresh parametre

Parameter Alias Påkrævet? Beskrivelse
--repo -r Ja En komplet URL-adresse til et lager, der ejes af en GitHub Enterprise Cloud-organisation. For eksempel https://contoso.ghe.com/contoso/my-app eller https://github.com/contoso/my-app. CLI udfører kun en minimal kontrol af, at URL-adressen har en vært (bruges til at udlede logonslutpunktet) og ikke selv gennemtvinger værts- eller skemaregler. Platformen er den myndighed, som værter og udbydere understøttes på. CLI spørger i interaktiv tilstand, hvis du ikke indstiller denne værdi.
--open-browser Nej Start systembrowseren bedst muligt ud over at udskrive bekræftelses-URL-adressen. Standarden er kun udskrift.

Opret en app

Brug disse kommandoer til at oprette en ny Copilot Runtime-app eller registrere et eksisterende projekt.

Konfigurer lagersynlighed og andre politikker for administration af lager i GitHub Enterprise Cloud. Få mere at vide under Gennemtvingelse af politikker for administration af lager i din virksomhed.

ms app create

Opret en ny app, stillads en projektskabelon i mappen, og konfigurer kildekontrol.

ms app create --display-name <name> [directory] [options]

ms app create parametre

Parameter Alias Påkrævet? Beskrivelse
--display-name <name> -n Ja Visningsnavn for appen.
[directory] Nej Mappen Destination. Standardindstillingen er den aktuelle mappe. Skal være tom.
--environment-id <id> -e Nej Destinationsmiljø. Når det udelades, bruger CLI dit udviklermiljø og klargør et ved første kørsel.
--description <text> -d Nej Fritekstbeskrivelse gemt i appposten.
--template <name> -t Nej GitHub-lager eller -understi, github:owner/repo/subdirsom appen skal anvendes fra (f.eks. ). Standardindstillingen er den indbyggede Vite-skabelon. Gælder for alle --repo tilstande.
--repo <url> Nej Binding af kildekontrolelement. Udelad for platformsadministreret (GRS) Git (standard). Overføre en komplet https:// URL-adresse til et lager, der ejes af en GitHub Enterprise Cloud-organisation, https://contoso.ghe.com/contoso/my-app for eksempel eller https://github.com/contoso/my-app – for at klone og binde et eksisterende tomt eksternt GitHub-lager. Gennemgå none for at springe al Git-binding over (stillads skabelonen, og skriv ms.config.json kun uden lokalt lager eller fjernbetjening). Kan ikke kombineres med --repository-id.
--repository-id <id> -r Nej Lager-id, der skal knyttes til appen for kildekontrolelementet. Kan ikke kombineres med --repo.
--build-path <path> -b Nej Opbyg outputmappe. Standardværdien er ./dist.
--build-command <cmd> -S Nej Fuld shell-kommando, der bruges til at bygge appen. Standardværdien er npm run build.
--build-entry-point <file> Nej HTML-fil for indgangspunkt. Standardværdien er index.html.
--open-browser Nej Start systembrowseren optimalt, hvis der er brug for gengodkendelse af enhedskodeflow. Har ingen effekt med --json.
--force-reauth Nej Omgå den gemte GitHub-tilknytning, og gennemtving enhedskodeflow, som om tilknytningen var udløbet. Påvirker kun apps, der er bundet til et eksternt GitHub-lager.

Bemærk!

  • For --repo <url>, kloner CLI det eksterne GitHub-lager i mappen og overlejrer skabelonen. Lageret skal findes og være tomt.
  • CLI --repo nonestilladserer skabelonen og skriver, men initialiserer ms.config.json ikke et lokalt Git-lager eller binder en fjernbetjening. Dette opretter en app til ekstern artefaktudrulning, som du selv bygger og installerer. Du kan f.eks. se Udrul Microsoft Copilot Managed Runtime-apps med GitHub Actions.
  • Hvis GitHub-tilknytningen mangler eller er udløbet, ms app create køres enhedskodeflowet in-band og prøver igen én gang.

ms app init

Registrer et eksisterende webprojekt som en app uden stilladsfiler.

ms app init --display-name <name> [options]

ms app init parametre

Parameter Alias Påkrævet? Beskrivelse
--display-name <name> -n Ja Visningsnavn for appen.
--environment-id <id> -e Nej Destinationsmiljø. Standardindstillinger for brugerens udviklermiljø.
--description <text> -d Nej Fritekstbeskrivelse.
--build-path <path> -b Nej Opbyg outputmappe. Standardværdien er ./dist.
--build-command <cmd> -S Nej Fuld shell-kommando, der bruges til at bygge appen. Standardværdien er npm run build.
--build-entry-point <file> Nej HTML-fil for indgangspunkt. Standardværdien er index.html.
--repo <value> Nej Lagerets funktionsmåde. Udelad automatisk at registrere den aktuelle Git-konfiguration (og spørg i interaktiv tilstand). Gennemtving native et platformsadministreret (GRS) lager til udrulning af eksterne artefakter (intet platformsadministreret lager) eller en URL-adresse til et lager til at binde til et eksisterende GitHub-lager, none der allerede er klonet i det aktuelle katalog.
--icon-path <path> Nej Valgfri sti til et ikon eller .jpg appikon.png, skrevet til ms.config.json som iconPath.
--local-app-url <url> Nej Valgfri URL-adresse til lokal udvikling, skrevet til ms.config.json som localAppUrl.
--open-browser Nej Start systembrowseren efter bedste evne under Device Code Flow. Har ingen effekt med --json.
--force-reauth Nej Omgå den gemte GitHub-tilknytning, og gennemtving enhedskodeflow i første forsøg. Nyttig til at gendanne en beskadiget tilknytning.

Bemærk!

  • Mislykkes, hvis den aktuelle mappe allerede er en app.
  • Stilladserer ikke skabelonfiler. Funktionsmåden for kildekontrol afhænger af --repo (registreres automatisk fra den aktuelle mappe, når den udelades).
  • For den eksterne GitHub-gren gælder den samme indbyggede enhedskodeflow som med ms app create.

ms app clone

Klon en eksisterende apps platformsadministrerede Git-lager, og konfigurer Git-godkendelse til fremtidige hente- og pushhandlinger.

ms app clone --app <app-id> [directory]

ms app clone parametre

Parameter Alias Påkrævet? Beskrivelse
--app <app-id> Ja App-id for en app, du har redigeringsadgang til. Bruges ms app list --permission edit til at finde app-id'et.
[directory] Nej Destinationsmappe for det klonede lager. Hvis det udelades, bruger CLI den aktuelle mappe, som skal være tom.

Bemærk!

ms app clone understøtter platformsadministrerede Git-lagre. For en app, der bruger et eksternt GitHub- eller GitHub Enterprise Cloud-lager, skal du bruge git clone <repository-url> den i stedet. Du kan ikke klone en app, der ikke har en kildekontrolelementbinding.

Find forbindelser

Brug disse kommandoer til at finde tilgængelige forbindelser, og undersøg deres handlinger, før du føjer dem til din app.

ms connector list

Liste over forbindelser, der er tilgængelige i et miljø.

ms connector list [--environment-id <id>] [--search <term>] [--include-blocked]

Outputtet omfatter forbindelses-id, godkendelsestype, tabular-supportflag samt DLP (Data Loss Prevention) og ACP-status (Advanced Connector Policy). Ved at se styringsstatus på designtidspunktet kan du undgå at bygge mod en forbindelse, som politikblokerer på installations- eller kørselstidspunktet.

ms connector list parametre

Parameter Alias Påkrævet? Beskrivelse
--environment-id <id> -e Nej Miljø til forespørgsler. Standarder fra ms.config.json , når de er til stede.
--search <term> -s Nej Filtrer efter understrengsmatch på forbindelsens viste navn eller id (der skelnes ikke mellem store og små bogstaver).
--include-blocked Nej Liste også connectorer, der er blokeret af lejerpolitik. Som standard vises kun tilladte forbindelser.

ms connector list-actions

Vis en liste over de handlinger, der eksponeres af en forbindelse, herunder DLP-status pr. handling.

ms connector list-actions [--environment-id <id>] --connector <connector> [--search <term>]

ms connector list-actions parametre

Parameter Alias Påkrævet? Beskrivelse
--connector <connector> Ja Forbindelse, der skal undersøges, efter id.
--environment-id <id> -e Nej Miljø til forespørgsler. Standarder fra ms.config.json , når de er til stede.
--search <term> -s Nej Filtrer efter understrengsmatch på handlingsoversigt eller handlings-id (skelner mellem store og små bogstaver).

Administrer appressourcer

Brug disse kommandoer til at tilføje, fjerne og opdatere de datakilder, som din app afhænger af.

Tilføj appressourcer

Kør alle add kommandoer fra den mappe, der indeholder din app. Som standard genererer de TypeScript-modeller og -tjenester under generated/.

ms app add data-source

Føj en forbindelse til appen, og vælg automatisk mellem tabel- og handlingsdatakilder.

ms app add data-source --connector <connector> [options]

Bemærk!

  • CLI tilføjer automatisk forbindelser, der ikke er i tabelformat, som handlinger.
  • CLI beder om tabel kontra handling i interaktiv tilstand for tabelforbindelser. Du skal angive --as i ikke-interaktiv tilstand.
  • DLP og ACP preflight kører, før en handling eller tabel tilføjes. CLI filtrerer blokerede handlinger fra og rapporterer, at optællingen er sprunget over.

ms app add data-source parametre

Parameter Alias Påkrævet? Beskrivelse
--connector <connector> Ja Forbindelse, der skal tilføjes, efter id (f.eks. shared_office365) eller vist navn, fra ms connector list.
--as <mode> Betinget Gennemtving table eller action send. Påkrævet i ikke-interaktiv tilstand, når forbindelsen understøtter tabeller.
--connection-id <id> -c Nej Eksisterende forbindelse, der skal bruges. CLI-prompten, når den udelades.
--dataset <name> -d Nej Datasæt (bruges sammen med --as table).
--table <name> -t Nej Tabel, der skal tilføjes (bruges sammen med --as table). For Dataverse (shared_commondataserviceforapps), tabellens logiske navn.
--dataverse-environment-id <guid> Nej Dataverse-miljø-id. Bruges kun med --connector shared_commondataserviceforapps til at binde til en bestemt tabel.
--use-sso Nej Foretrækker en single sign-on-forbindelse (Entra ID): genbrug den første eksisterende SSO-forbindelse, eller opret en automatisk. Fejl, hvis forbindelsen ikke er SSO-kompatibel. Ignoreres, når --connection-id den leveres.

Fjern appressourcer

Kommandoer til fjernelse beder om bekræftelse, medmindre du består --force.

ms app remove data-source

Fjerne en tidligere tilføjet datakilde (tabel eller handling) fra appen.

ms app remove data-source [--name <name>] [--force]

ms app remove data-source parametre

Parameter Alias Påkrævet? Beskrivelse
--name <name> -n Nej Navnet på den datakilde, der skal fjernes. CLI beder dig om at vælge mellem appens datakilder, når den udelades.
--force -f Nej Springer bekræftelsesprompten over.

Opdater appressourcer

Brug denne kommando til at synkronisere genererede apptyper med de seneste ændringer i kildeskemaet.

ms app refresh data-source

Hent skemaet igen, og gendan TypeScript for bundne datakilder.

ms app refresh data-source [--name <name>]

Kør denne kommando, efter de underliggende skemaændringer (f.eks. en ny kolonne på en SharePoint-liste) for at holde det genererede TypeScript synkroniseret.

ms app refresh data-source parametre

Parameter Alias Påkrævet? Beskrivelse
--name <name> -n Nej Opdatere en bestemt datakilde. Undlad at opdatere alle bundne kilder.

Udvikl lokalt

Brug disse kommandoer til at køre din app lokalt med konfigurationsserveren til gentaget udvikling.

ms app dev

Start det fulde lokale udviklingskredsløb.

ms app dev [--port <n>] [--local-app-url <url>] [--config-only]

CLI starter projektets udviklingsproces sammen med en lokal konfigurationsserver. URL-adressen til afspilning udskrives, når begge er tilgængelige. Tryk Ctrl+C på for at stoppe dem rent.

ms app dev parametre

Parameter Alias Påkrævet? Beskrivelse
--port <n> -p Nej Port til konfigurationsserveren. Standardværdien er 8080.
--local-app-url <url> -l Nej URL-adresse, hvor udviklerserveren er tilgængelig. Standardværdien er http://localhost:3000.
--config-only -C Nej Start kun konfigurationsserveren, når du kører udviklingsserveren separat (f.eks. under en processtyring).

Byg og installer

Brug disse kommandoer til at pakke lokalt, køre fjernbuilds og implementere en valideret bekræftelse.

ms app pack

Byg appen lokalt, og klargør outputtet til inspektion uden at uploade det nogen steder.

ms app pack

Brug denne kommando til at bekræfte, at et rent lokalt build lykkes, før et fjernbuild udløses.

ms app build

Udløs et platformsbuild for en bestemt bekræftelse på en Git-støttet app.

ms app build --app <name> --commit <sha> [--no-wait] [--open-browser] [--force-reauth]

ms app build parametre

Parameter Alias Påkrævet? Beskrivelse
--app <name> Nej Appnavn. Standarder fra ms.config.json , når de er til stede.
--commit <sha> -c Nej Commit to build. Standardværdien er den aktuelle HEAD.
--no-wait Nej Vend tilbage umiddelbart efter indsendelse, og udskriv et tip, der skal følges op med ms app build-status. Som standard venter kommandoen på, at buildet når en afsluttende tilstand.
--open-browser Nej Start systembrowseren, hvis der kræves gengodkendelse af enhedskodeflow for eksterne GitHub-lagre. Har ingen effekt med --json.
--force-reauth Nej Omgå den gemte GitHub-tilknytning, og gennemtving enhedskodeflow. Påvirker kun apps, der er bundet til et eksternt GitHub-lager.

ms app build-status

Kontrollér status for et build.

ms app build-status --app <name> --commit <sha> [--show-log]

Hvis buildet mislykkedes, indeholder outputtet årsagen, så du kan rette koden og skubbe igen.

ms app build-status parametre

Parameter Alias Påkrævet? Beskrivelse
--app <name> Nej App, der skal undersøges. Standarder fra ms.config.json , når de er til stede.
--commit <sha> -c Nej Bekræft dig til at kontrollere buildstatus. Standardværdien er den aktuelle HEAD.
--show-log Nej Hent og udskriv buildloggen, når den er tilgængelig.

ms app deploy

Fremhæv et grønt build til liveappen.

ms app deploy [--app <name>] [--commit <sha>] [--artifact <path>] [--open-browser] [--force-reauth]

Bemærk!

  • Kommandoen installeres i det miljø, der er knyttet til appen. Den vælger ikke et installationsmiljø.
  • For Git-støttede apps løser CLI bekræftelsen (standard HEAD), advarer om ikke-bekræftede lokale ændringer, sætter et fjernbuild i kø, forespørger til færdiggørelse og installerer det resulterende build.
  • For apps uden kildekontrol (repoType: none), pakker og uploader CLI det lokale build eller uploader et forudbygget .zip , når --artifact det leveres.

ms app deploy parametre

Parameter Alias Påkrævet? Beskrivelse
--app <name> Nej App, der skal installeres. Standarder fra ms.config.json.
--commit <sha> -c Nej Engager dig til installation (kun Git-understøttede apps). Standardværdien er den aktuelle HEAD. Gensidigt udelukker med --artifact.
--artifact <path> Nej Sti til en lokal .zip buildartefakt til upload og installation. Gælder kun for apps, der er oprettet uden kildekontrol (repoType: none); afvist på Git-understøttede apps. Gensidigt udelukker med --commit.
--open-browser Nej Start systembrowseren optimalt, hvis der er brug for gengodkendelse af enhedskodeflow. Har ingen effekt med --json.
--force-reauth Nej Omgå den gemte GitHub-tilknytning, og gennemtving enhedskodeflow. Påvirker kun apps, der er bundet til et eksternt GitHub-lager.

ms app deploy --artifact <path> Uploader og installerer artefaktet uden et platformsadministreret build. Installation af eksterne artefakter er som standard ikke tilladt. Se Udrulning af eksterne artefakter.

Din organisation er ansvarlig for at validere eksternt byggede artefakter og sikre buildpipelinen før udrulning.

Afspil

Brug denne kommando til at åbne din app i live- eller eksempeltilstand.

ms app play

Åbn en app i browseren, og udskriv dens start-URL-adresse.

ms app play [--app <name>] [--mode live | preview] [--commit <sha>] [--no-browser]

ms app play parametre

Parameter Alias Påkrævet? Beskrivelse
--app <name> Nej App, der skal åbnes. Standarder fra ms.config.json.
--mode <mode> -m Nej live Åbner den installerede app. preview åbner det nyeste build på main, eller en bestemt bekræftelse, når det kombineres med --commit. Standardværdien er live.
--commit <sha> -c Nej Åbn eksemplet ved en bestemt bekræftelse. Gælder kun med --mode preview.
--no-browser Nej Udskriv start-URL'en uden at åbne standardbrowseren. Nyttig til SSH-sessioner, CI og scripts.

Bemærk!

--mode live Advarer om, at livebuildet er et øjebliksbillede og ikke opdateres automatisk. Kør ms app deploy igen for at opdatere den. Hvis appen aldrig installeres, --mode live mislykkes den med en brugsfejl, der peger dig mod ms app deploy.

Del

Brug disse kommandoer til at tildele, tilbagekalde og administrere appadgang og dele links.

ms app share

Giv adgang til brugere eller grupper.

ms app share <principals> [--app <name>] [--access play | edit]

Kommandoen slår automatisk mailadresser op. Det rapporterer advarsler for poster, der ikke løses, men fortsætter med dem, der gør. Hvis ingen poster løser problemet, mislykkes kommandoen.

ms app share parametre

Parameter Alias Påkrævet? Beskrivelse
<principals> Ja Kommasepareret liste over mailadresser eller Microsoft Entra-objekt-id'er.
--app <name> Nej App til deling. Standarder fra ms.config.json.
--access <level> Nej Tildel kørselsadgang (playstandard) eller lagerredigeringsadgang (edit).

ms app unshare

Tilbagekalde tidligere tildelt adgang.

ms app unshare <principals> [--app <name>] [--access play | edit]

Kommandoen unshare påvirker kun det ønskede adgangsniveau. Lader f.eks unshare --access edit . Access være play intakt. Principaler uden en eksisterende rolletildeling på det anmodede niveau er no-ops.

ms app unshare parametre

Parameter Alias Påkrævet? Beskrivelse
<principals> Ja Kommasepareret liste over mailadresser eller Microsoft Entra-objekt-id'er.
--app <name> Nej app til at ophæve deling. Standarder fra ms.config.json.
--access <level> Nej Tilbagekalde kørselsadgang (playstandard) eller lagerredigeringsadgang (edit).

ms app share list

Angiv de brugere og grupper, en app deles med på et givet adgangsniveau.

ms app share list --access <level> [--app <name>] [--environment-id <id>]

ms app share list parametre

Parameter Alias Påkrævet? Beskrivelse
--access <level> Ja Adgangsniveau til liste. Enten play (kør appen) eller edit (rediger det underliggende lager).
--app <name> Nej App, der skal undersøges. Standarder fra ms.config.json.
--environment-id <id> -e Nej Tilsidesæt miljø-id'et. Standarder fra ms.config.json , når de er til stede.

Opret et delingslink for hele lejeren til appen.

ms app share link create [--app <name>] [--environment-id <id>]
Parameter Alias Påkrævet? Beskrivelse
--app <name> Nej App til deling. Standarder fra ms.config.json.
--environment-id <id> -e Nej Tilsidesæt miljø-id'et. Standarder fra ms.config.json , når de er til stede.

Listedelingslinks, der er udstedt til appen.

ms app share link list [--app <name>] [--environment-id <id>]
Parameter Alias Påkrævet? Beskrivelse
--app <name> Nej App, der skal undersøges. Standarder fra ms.config.json.
--environment-id <id> -e Nej Tilsidesæt miljø-id'et. Standarder fra ms.config.json , når de er til stede.

Tilbagekald et delingslink efter id. Denne kommando fjerner alle tidligere indløsers roller, før den river linkposten ned.

ms app share link revoke --link-id <id> [--app <name>] [--environment-id <id>] [--force]
Parameter Alias Påkrævet? Beskrivelse
--link-id <id> -l Ja Link-id'et, der blev returneret fra ms app share link create.
--app <name> Nej App, der ejer linket. Standarder fra ms.config.json.
--environment-id <id> -e Nej Tilsidesæt miljø-id'et. Standarder fra ms.config.json , når de er til stede.
--force -f Nej Springer bekræftelsesprompten over.

Undersøg og administrer

Brug disse kommandoer til at få vist appens tilstand, opdatere indstillinger og fjerne apps, når det er nødvendigt.

ms app list

Vis alle apps, du har adgang til. Som standard viser alle apps i lejeren. Overfør --environment-id til område til et enkelt miljø.

ms app list [--environment-id <id>] [--permission <level>]

Returnerer visningsnavn, app-id, lager-URL-adresse og ejere for hver app.

ms app list parametre

Parameter Alias Påkrævet? Beskrivelse
--environment-id <id> -e Nej Afgræns listen til et enkelt miljø. Når den udelades, returneres alle apps, som du har adgang til på tværs af lejeren.
--permission <level> -p Nej Tilladelsesfilter. Enten edit (apps, du kan bidrage til; standard) eller play (apps, du kan afspille/få vist). Skelner ikke mellem store og små bogstaver.

ms app show

Vis konfigurationen af den lokale app og alle bundne ressourcer.

ms app show

Læser den lokale konfiguration af appen i den aktuelle mappe.

ms app info

Viser appens tilstand på serversiden.

ms app info [--app <name>] [--environment-id <id>]

Returnerer vist navn, app-id, lager-URL-adresse, ejere, miljø-id, senest udrullede bekræftelse og live- og eksempel-URL-adresser.

ms app info parametre

Parameter Alias Påkrævet? Beskrivelse
--app <name> Nej Navnet på den app, der skal undersøges. Standarder fra ms.config.json. Overfør et eksplicit navn for at undersøge en app uden for den aktuelle arbejdsmappe.
--environment-id <id> -e Nej Tilsidesæt miljø-id'et. Standardindstillinger fra ms.config.json; når ingen af delene er angivet, løses miljøet automatisk fra appnavnet.

ms app get-settings

Viser alle appindstillinger og deres aktuelle værdier.

ms app get-settings

Få mere at vide om, hvordan du får vist appindstillinger

ms app set-setting

Opdateringer en eller flere appindstillinger.

ms app set-setting [--show-header <bool>] [other-settings...]

Adgangsindstillinger som navngivne flag. Det er kun de taster, du angiver, der opdateres.

ms app set-setting parametre

Parameter Alias Påkrævet? Beskrivelse
--show-header <bool> Nej Vis eller skjul appens overskriftslinje.
[other-settings...] Nej Et eller flere navngivne indstillingsflag, der skal opdateres. Kun angivne nøgler ændres.

Få mere at vide om, hvordan du konfigurerer en appindstilling

ms app delete

Sletter appen fra miljøet. Sletter ikke den lokale kildekode eller Git-lageret.

ms app delete [--app <name>] [--environment-id <id>] [--force]

Hvis appen ikke findes, afsluttes kommandoen uden fejl.

ms app delete parametre

Parameter Alias Påkrævet? Beskrivelse
--app <name> Nej App, der skal slettes. Standarder fra ms.config.json.
--environment-id <id> -e Nej Tilsidesæt miljø-id'et. Når det udelades, løses miljøet automatisk fra appen. Nyttig til at slette en app uden for dens stilladsmappe.
--force -f Nej Springer bekræftelsesprompten over.

Telemetri

CLI sender anonymiseret telemetri som standard. Brug disse kommandoer til at styre indsamlingen.

ms telemetry enable

Slå indsamling af telemetri til.

ms telemetry enable [--remote] [--console]

ms telemetry enable parametre

Parameter Alias Påkrævet? Beskrivelse
--remote Nej Kontrollér afsendelse af telemetri til fjerntjenesten. Denne indstilling er standardindstillingen, når der ikke angives noget flag.
--console Nej Udskriv telemetrihændelser til den lokale konsol.

Passere begge flag for at slå begge mål mellem på én gang.

ms telemetry disable

Slå indsamling af telemetri fra.

ms telemetry disable [--remote] [--console]

ms telemetry disable parametre

Parameter Alias Påkrævet? Beskrivelse
--remote Nej Stop med at sende telemetri til fjerntjenesten. Denne indstilling er standardindstillingen, når der ikke angives noget flag.
--console Nej Stop med at udskrive telemetrihændelser til den lokale konsol.

Overfører begge flag for at deaktivere begge mål på én gang.

ms telemetry status

Vise de aktuelle indstillinger for telemetri.

ms telemetry status
  • Sidst opdateret den