Informazioni di riferimento sui comandi dell'interfaccia della riga di comando di Copilot Managed Runtime

Questo articolo descrive ogni comando dell'interfaccia della riga di comando di Copilot Managed Runtime con sintassi e parametri che consentono di creare, distribuire e condividere app dalla riga di comando. L'interfaccia a riga di comando di Copilot Managed Runtime viene pubblicata e @microsoft/cmr-cli richiamata come ms.

La maggior parte dei comandi opera sull'app nella directory corrente e legge i valori predefiniti dalla sua configurazione locale (nome dell'app, ambiente, binding del repository). Esegui i comandi dalla directory che contiene la tua app, a meno che un flag non ti consenta esplicitamente di scegliere come destinazione un'altra app.

Questo riferimento raggruppa tutti i comandi in base alle tipiche attività del flusso di lavoro dello sviluppatore:

Gruppo Comando Descrizione
Autenticazione ms auth login Accedi a Microsoft Entra ID tramite il browser.
Autenticazione ms auth logout Cancella le credenziali memorizzate nella cache e rimuovi il puntatore all'account attivo.
Autenticazione ms auth status Elencare gli account memorizzati nella cache e indicare quello attivo.
Autenticazione ms auth switch Attivare un altro account memorizzato nella cache.
Autenticazione ms git auth refresh Aggiornare o stabilire il mapping di identità da Entra a GitHub.
Creare un'app ms app create Creare una nuova app e creare lo scaffolding di un modello di progetto.
Creare un'app ms app clone Clonare il repository Git gestito dalla piattaforma di un'app esistente.
Creare un'app ms app init Registrare un progetto Web esistente come app.
Individuare i connettori ms connector list Elencare i connettori disponibili in un ambiente.
Individuare i connettori ms connector list-actions Elencare le operazioni esposte da un connettore.
Gestione delle risorse dell'app ms app add backend Aggiungere un back-end del database di Fabric all'app.
Gestione delle risorse dell'app ms app add data-source Aggiungere un connettore all'app come origine dati tabella o azione.
Gestione delle risorse dell'app ms app remove data-source Rimuovere dall'app un'origine dati (tabella o azione) aggiunta in precedenza.
Gestione delle risorse dell'app ms app refresh data-source Recupera di nuovo lo schema e rigenera TypeScript per le origini dati associate.
Sviluppare localmente ms app dev Avvia l'intero ciclo di sviluppo locale.
Compilare e distribuire ms app pack Crea l'app localmente e prepara l'output per l'ispezione.
Compilare e distribuire ms app build Attivare la compilazione di una piattaforma per un commit specifico.
Compilare e distribuire ms app build-status Controllare lo stato di una build.
Compilare e distribuire ms app deploy Promuovi una build ecologica per l'app live.
Gioca ms app play Aprire un'app e stamparne l'URL di avvio.
Condivisione ms app share Concedere l'accesso a utenti o gruppi.
Condivisione ms app share list Elencare gli utenti e i gruppi con cui un'app è condivisa.
Condivisione ms app unshare Revoca l'accesso concesso in precedenza.
Condivisione ms app share link create Creare un collegamento di condivisione a livello di tenant per l'app.
Condivisione ms app share link list Collegamenti di condivisione elenco rilasciati per l'app.
Condivisione ms app share link revoke Revocare un collegamento di condivisione per ID.
Ispezione e gestione ms app list Elenca le app nell'ambiente a cui puoi accedere.
Ispezione e gestione ms app info Mostrare lo stato sul lato server dell'app.
Ispezione e gestione ms app get-settings Mostra tutte le impostazioni dell'app e i loro valori correnti.
Ispezione e gestione ms app set-setting Aggiorna una o più impostazioni dell'app.
Ispezione e gestione ms app delete Eliminare l'app dall'ambiente.
Amministrazione ms admin add owner Aggiungere uno o più proprietari dell'app.
Amministrazione ms admin remove owner Rimuovere uno o più proprietari dell'app.
Telemetria ms telemetry enable Attivare la raccolta di dati di telemetria.
Telemetria ms telemetry disable Disattiva la raccolta dei dati di telemetria.
Telemetria ms telemetry status Mostra le impostazioni di telemetria correnti.

Indice comandi

Nella tabella seguente sono elencati i comandi in ordine alfabetico:

Comando Gruppo Descrizione
ms admin add owner Amministrazione Aggiungere uno o più proprietari dell'app.
ms admin remove owner Amministrazione Rimuovere uno o più proprietari dell'app.
ms app add backend Gestione delle risorse dell'app Aggiungere un back-end del database di Fabric all'app.
ms app add data-source Gestione delle risorse dell'app Aggiungere un connettore all'app come origine dati tabella o azione.
ms app build Compilare e distribuire Attivare la compilazione di una piattaforma per un commit specifico.
ms app build-status Compilare e distribuire Controllare lo stato di una build.
ms app clone Creare un'app Clonare il repository Git gestito dalla piattaforma di un'app esistente.
ms app create Creare un'app Creare una nuova app e creare lo scaffolding di un modello di progetto.
ms app delete Ispezione e gestione Eliminare l'app dall'ambiente.
ms app deploy Compilare e distribuire Promuovi una build ecologica per l'app live.
ms app dev Sviluppare localmente Avvia l'intero ciclo di sviluppo locale.
ms app get-settings Ispezione e gestione Mostra tutte le impostazioni dell'app e i loro valori correnti.
ms app info Ispezione e gestione Mostrare lo stato sul lato server dell'app.
ms app init Creare un'app Registrare un progetto Web esistente come app.
ms app list Ispezione e gestione Elenca le app nell'ambiente a cui puoi accedere.
ms app pack Compilare e distribuire Crea l'app localmente e prepara l'output per l'ispezione.
ms app play Gioca Aprire un'app e stamparne l'URL di avvio.
ms app refresh data-source Gestione delle risorse dell'app Recupera di nuovo lo schema e rigenera TypeScript per le origini dati associate.
ms app remove data-source Gestione delle risorse dell'app Rimuovere dall'app un'origine dati (tabella o azione) aggiunta in precedenza.
ms app set-setting Ispezione e gestione Aggiorna una o più impostazioni dell'app.
ms app share Condivisione Concedere l'accesso a utenti o gruppi.
ms app share list Condivisione Elencare gli utenti e i gruppi con cui un'app è condivisa.
ms app share link create Condivisione Creare un collegamento di condivisione a livello di tenant per l'app.
ms app share link list Condivisione Collegamenti di condivisione elenco rilasciati per l'app.
ms app share link revoke Condivisione Revocare un collegamento di condivisione per ID.
ms app unshare Condivisione Revoca l'accesso concesso in precedenza.
ms auth login Autenticazione Accedi a Microsoft Entra ID tramite il browser.
ms auth logout Autenticazione Cancella le credenziali memorizzate nella cache e rimuovi il puntatore all'account attivo.
ms auth status Autenticazione Elencare gli account memorizzati nella cache e indicare quello attivo.
ms auth switch Autenticazione Attivare un altro account memorizzato nella cache.
ms connector list Individuare i connettori Elencare i connettori disponibili in un ambiente.
ms connector list-actions Individuare i connettori Elencare le operazioni esposte da un connettore.
ms git auth refresh Autenticazione Aggiornare o stabilire il mapping di identità da Entra a GitHub.
ms telemetry disable Telemetria Disattiva la raccolta dei dati di telemetria.
ms telemetry enable Telemetria Attivare la raccolta di dati di telemetria.
ms telemetry status Telemetria Mostra le impostazioni di telemetria correnti.

Flag globali

Ogni comando accetta i seguenti flag.

Contrassegno Alias Obbligatorio? Descrizione
--json No Restituisce il risultato come un singolo oggetto JSON (o NDJSON per i comandi di streaming). Usare questo flag in script e CI.
--non-interactive No Esecuzione senza prompt. Fornisci tutti i valori richiesti tramite flag o variabili di ambiente. Usare questo flag in script e CI.
--no-color No Disabilita output colorato.
--cloud <cloud> No Ambiente cloud di destinazione. I valori validi sono public (impostazione predefinita), usgov, usgovhigh, usgovdode china.
--version -v No Stampare la versione dell'interfaccia della riga di comando.
--help -h No Mostra la Guida per il comando, inclusi tutti i contrassegni disponibili.

Consiglio

Eseguire ms senza argomenti per la guida di primo livello raggruppata, ms app per i sottocomandi delle app e ms app <verb> --help per i flag di un verbo. Le funzionalità emergono progressivamente man mano che si procede con l'approfondimento.

Autenticazione

Accedere una volta per ogni computer. Tutti gli altri comandi presuppongono una sessione autenticata rispetto a un tenant abilitato per il runtime gestito da Copilot.

ms auth login

Accedi a Microsoft Entra ID tramite il browser. Aggiunge il nuovo account alla cache e lo rende attivo.

ms auth login [--account <email>]

ms auth login account parametro

Tenta di accedere come account selezionato, utile per scenari con più account. Per scegliere tra gli account già memorizzati nella cache, usare ms auth switch invece.


ms auth logout

Cancella tutte le credenziali memorizzate nella cache e rimuovi il puntatore all'account attivo.

ms auth logout

Per modificare l'account attivo senza disconnettersi, usare ms auth switch.


ms auth status

Elencare gli account memorizzati nella cache. Quando viene memorizzato nella cache più di un account, l'account attivo (quello usato dagli altri comandi) viene contrassegnato con *.

ms auth status

ms auth switch

Attivare un account memorizzato nella cache diverso per i comandi successivi.

ms auth switch [--account <email>]

ms auth switch account parametro

Account da attivare. In modalità interattiva con più account memorizzati nella cache, l'interfaccia della riga di comando richiede la selezione se questo flag viene omesso. Obbligatorio in modalità non interattiva e quando si utilizza --json.

Autenticazione Git

Alcuni comandi devono verificare che l'identità Microsoft Entra sia mappata a un utente GitHub con accesso al repository associato. La prima volta che è necessario un mapping, ms app create, ms app build, ed ms app deploy esegui il flusso di codice del dispositivo GitHub inline: non è necessario aggiornare in modo proattivo per la prima configurazione. Da usare ms git auth refresh per ripetere l'autenticazione in modo esplicito (ad esempio, quando si cambia account GitHub).

ms git auth refresh

Aggiornare o stabilire il mapping delle identità GitHub di Microsoft Entra ↔ per un repository di proprietà di un'organizzazione GitHub Enterprise Cloud.

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

Il comando stampa l'URL di verifica e un codice utente da incollare in un browser. In caso di esito positivo, stampa l'account di accesso GitHub autenticato e il timestamp di scadenza del mapping. Premere Ctrl+C per annullare il ciclo di polling in modo pulito.

ms git auth refresh Parametri

Parametro Alias Obbligatorio? Descrizione
--repo -r Sì URL completo di un repository di proprietà di un'organizzazione GitHub Enterprise Cloud. Ad esempio, https://contoso.ghe.com/contoso/my-app o https://github.com/contoso/my-app. L'interfaccia della riga di comando esegue solo un controllo minimo che l'URL abbia un host (usato per derivare l'endpoint di accesso) e non applichi regole dell'host o dello schema. La piattaforma è l'autorità su cui sono supportati host e provider. Se non si imposta questo valore, l'interfaccia della riga di comando viene visualizzata in modalità interattiva.
--open-browser No Procedura consigliata: avvia il browser di sistema oltre a stampare l'URL di verifica. L'impostazione predefinita è la sola stampa.

Creare un'app

Usa questi comandi per creare una nuova app Copilot Runtime o registrare un progetto esistente.

Configura la visibilità del repository e altri criteri di gestione del repository in GitHub Enterprise Cloud. Per ulteriori informazioni, vedere Applicazione dei criteri di gestione dell'archivio nell'azienda.

ms app create

Creare una nuova app, inserire un'impalcatura di un modello di progetto nella directory e configurare il controllo del codice sorgente.

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

ms app create Parametri

Parametro Alias Obbligatorio? Descrizione
--display-name <name> -n Sì Nome visualizzato dell'app.
[directory] No Directory di destinazione. Deve essere vuoto. Se omesso, l'interfaccia della riga di comando crea una directory denominata in base al nome visualizzato dell'app. Passare . esplicitamente per usare la directory corrente.
--environment-id <id> -e No Ambiente di destinazione. Se omesso, l'interfaccia della riga di comando utilizza l'ambiente di sviluppo, effettuandone il provisioning alla prima esecuzione.
--description <text> -d No Descrizione a testo libero archiviata nel record dell'app.
--template <name> -t No repository GitHub o percorso secondario da cui eseguire lo scaffolding dell'app (ad esempio, github:owner/repo/subdir). L'impostazione predefinita è il modello Vite integrato. Si applica a tutte le --repo modalità.
--repo <url> No Associazione del controllo del codice sorgente. Omettere per Git gestito dalla piattaforma (GRS) (impostazione predefinita). Passare un URL completo https:// per un repository di proprietà di un'organizzazione GitHub Enterprise Cloud, ad esempio, https://contoso.ghe.com/contoso/my-app o https://github.com/contoso/my-app per clonare e associare un repository GitHub esterno vuoto esistente. Pass none per saltare tutta l'associazione Git (impalcatura del modello e sola scrittura ms.config.json , senza repository locale o remoto). Non può essere combinato con --repository-id.
--repository-id <id> -r No ID repository da associare all'app per il controllo del codice sorgente. Non può essere combinato con --repo.
--build-path <path> -b No Directory di output di compilazione. Il valore predefinito è ./dist.
--build-command <cmd> -S No Comando shell completo usato per compilare l'app. Il valore predefinito è npm run build.
--build-entry-point <file> No File HTML del punto di ingresso. Il valore predefinito è index.html.
--open-browser No Avvia il browser di sistema se è necessaria una nuova autenticazione del flusso del codice del dispositivo. Non ha alcun effetto con --json.
--force-reauth No Ignorare il mapping GitHub memorizzato e forzare il flusso del codice del dispositivo, come se il mapping fosse scaduto. Riguarda solo le app associate a un repository GitHub esterno.

Nota

  • Per --repo <url>, l'interfaccia della riga di comando clona il repository GitHub esterno nella directory e si sovrappone al modello. Il repository deve esistere ed essere vuoto.
  • Per --repo none, l'interfaccia della riga di comando esegue lo scaffolding del modello e scrive ms.config.json , ma non inizializza un repository Git locale o associa un telecomando. In questo modo viene creata un'app per la distribuzione di artefatti esterni che viene compilata e distribuita manualmente. Per un esempio, vedere Distribuire le app di runtime gestito di Microsoft Copilot con GitHub Actions.
  • Se il mapping GitHub è mancante o scaduto, ms app create eseguire il flusso di codice dispositivo in banda e riprovare una volta.

ms app init

Registrare un progetto Web esistente come app senza file di scaffolding.

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

ms app init Parametri

Parametro Alias Obbligatorio? Descrizione
--display-name <name> -n Sì Nome visualizzato dell'app.
--environment-id <id> -e No Ambiente di destinazione. Il valore predefinito è l'ambiente di sviluppo dell'utente.
--description <text> -d No Descrizione a testo libero.
--build-path <path> -b No Directory di output di compilazione. Il valore predefinito è ./dist.
--build-command <cmd> -S No Comando shell completo usato per compilare l'app. Il valore predefinito è npm run build.
--build-entry-point <file> No File HTML del punto di ingresso. Il valore predefinito è index.html.
--repo <value> No Comportamento del repository. Ometti per rilevare automaticamente la configurazione corrente di Git (e richiedi in modalità interattiva). Passaggio native per forzare un repository none gestito dalla piattaforma per la distribuzione di artefatti esterni (nessun repository gestito dalla piattaforma) o un URL di repository per l'associazione a un repository GitHub esistente già clonato nella directory corrente.
--icon-path <path> No Percorso facoltativo a un'icona .png dell'app o .jpg dell'app, scritto come ms.config.jsoniconPath.
--local-app-url <url> No URL di sviluppo locale facoltativo, scritto come ms.config.jsonlocalAppUrl.
--open-browser No Avvia il browser di sistema durante il flusso del codice del dispositivo. Non ha alcun effetto con --json.
--force-reauth No Ignora il mapping GitHub memorizzato e forza il flusso del codice del dispositivo al primo tentativo. Utile per recuperare una mappatura danneggiata.

Nota

  • Operazione non riuscita se la directory corrente è già un'app.
  • Non esegue lo scaffolding dei file modello. Il comportamento del controllo del codice sorgente dipende da --repo (rilevato automaticamente dalla directory corrente se omesso).
  • Per il ramo GitHub esterno, si applica la stessa riautenticazione inline di Device Code Flow di ms app create.

ms app clone

Clona il repository Git gestito dalla piattaforma di un'app esistente e configura l'autenticazione Git per le future operazioni di recupero e push.

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

ms app clone Parametri

Parametro Alias Obbligatorio? Descrizione
--app <app-id> Sì ID app di un'app a cui si dispone dell'accesso in modifica. Usa ms app list --permission edit per trovare l'ID dell'app.
[directory] No Directory di destinazione. Deve essere vuoto. Se omesso, l'interfaccia della riga di comando crea una directory denominata in base al nome visualizzato dell'app. Passare . esplicitamente per usare la directory corrente.

Nota

ms app clone supporta repository Git gestiti dalla piattaforma. Per un'app che usa un repository GitHub o GitHub Enterprise Cloud esterno, usare git clone <repository-url> invece. Non è possibile clonare un'app che non ha un'associazione per il controllo del codice sorgente.

Individuare i connettori

Usare questi comandi per trovare connettori disponibili e controllarne il funzionamento prima di aggiungerli all'app.

ms connector list

Elencare i connettori disponibili in un ambiente.

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

L'individuazione include i connettori bloccati dai criteri, a meno che non si superino --only-allowedi criteri . La tabella di testo include l'ID del connettore, il flag di supporto tabulare e uno stato dei criteri unificato basato su Prevenzione della perdita dei dati (DLP) e Criteri avanzati del connettore (ACP). L'output JSON include campi dei criteri e dei connettori più dettagliati.

ms connector list Parametri

Parametro Alias Obbligatorio? Descrizione
--environment-id <id> -e No Ambiente su cui eseguire query. L'impostazione predefinita da ms.config.json quando presente.
--search <term> -s No Filtro per corrispondenza di sottostringa in base al nome visualizzato o all'ID del connettore (senza distinzione tra maiuscole e minuscole).
--only-allowed No Elencare solo i connettori consentiti dai criteri. Per impostazione predefinita, l'individuazione include i connettori bloccati.

ms connector list-actions

Elencare le operazioni esposte da un connettore, incluso lo stato di prevenzione della perdita dei dati (DLP) per ogni operazione.

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

ms connector list-actions Parametri

Parametro Alias Obbligatorio? Descrizione
--connector <connector> Sì Connettore da ispezionare, specificato dall'ID.
--environment-id <id> -e No Ambiente su cui eseguire query. L'impostazione predefinita da ms.config.json quando presente.
--search <term> -s No Filtro per corrispondenza di sottostringa in base al riepilogo dell'operazione o all'ID azione (senza distinzione tra maiuscole e minuscole).

Gestione delle risorse dell'app

Usare questi comandi per aggiungere, rimuovere e aggiornare le origini dati da cui dipende l'app.

Aggiungere risorse dell'app

Eseguire tutti i add comandi della directory che contiene l'app. Per impostazione predefinita, ms app add data-source genera modelli e servizi TypeScript in generated/.


ms app add backend

Aggiungere un back-end del database di Fabric all'app. Prima di eseguire questo comando, un amministratore deve abilitare l'integrazione di Fabric per l'ambiente.

ms app add backend --provider fabric

ms app add backend Parametri

Parametro Alias Obbligatorio? Descrizione
--provider <provider> Sì Provider back-end da aggiungere. Attualmente, l'unico valore valido è fabric.

Per i prerequisiti e i dettagli sul back-end del database, vedere Integrazione dell'infrastruttura con Copilot Managed Runtime.


ms app add data-source

Aggiungere un connettore all'app. Il comando sceglie automaticamente tra le origini dati tabella e azione.

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

Nota

  • L'interfaccia della riga di comando aggiunge automaticamente connettori non tabulari come azioni.
  • L'interfaccia della riga di comando richiede tabella rispetto all'azione in modalità interattiva per i connettori tabulari. È necessario specificare --as in modalità non interattiva.
  • La verifica preliminare di DLP e ACP viene eseguita prima che il comando aggiunga qualsiasi azione o tabella. L'interfaccia della riga di comando filtra le operazioni bloccate e segnala che il conteggio è stato ignorato.

ms app add data-source Parametri

Parametro Alias Obbligatorio? Descrizione
--connector <connector> Sì Connettore da aggiungere, per ID (ad esempio, shared_office365) o nome visualizzato, da ms connector list.
--as <mode> Condizionale Forza table o action spedizione. Obbligatorio in modalità non interattiva quando il connettore supporta le tabelle.
--connection-id <id> -c No Connessione esistente da utilizzare. L'interfaccia della riga di comando chiede se omessa.
--dataset <name> -d No Set di dati (utilizzato con --as table).
--table <name> -t No Tabella da aggiungere (utilizzata con --as table). Per Dataverse (shared_commondataserviceforapps), il nome logico della tabella.
--dataverse-environment-id <guid> No ID ambiente Dataverse. Usato solo per --connector shared_commondataserviceforapps eseguire l'associazione a una tabella specifica.
--use-sso No Preferisci una connessione single sign-on (Entra ID): riutilizza la prima connessione SSO esistente o creane automaticamente una. Errori se il connettore non supporta SSO. Ignorato quando --connection-id viene fornito.

Rimuovere le risorse dell'app

In modalità interattiva, i comandi di rimozione richiedono la conferma, a meno che non si superino --forcei passaggi . In modalità non interattiva, la rimozione procede senza conferma anche quando si omette --force.

ms app remove data-source

Rimuovere dall'app un'origine dati (tabella o azione) aggiunta in precedenza.

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

ms app remove data-source Parametri

Parametro Alias Obbligatorio? Descrizione
--name <name> -n No Nome dell'origine dati da rimuovere. L'interfaccia della riga di comando richiede di scegliere tra le origini dati dell'app se omessa.
--force -f No Ignora la richiesta di conferma.

Aggiornare le risorse dell'app

Usare questo comando per sincronizzare i tipi di app generati con le ultime modifiche dello schema di origine.

ms app refresh data-source

Recupera di nuovo lo schema e rigenera TypeScript per le origini dati associate.

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

Eseguire questo comando dopo le modifiche dello schema sottostante (ad esempio, una nuova colonna in un elenco di SharePoint) per mantenere sincronizzato il TypeScript generato.

ms app refresh data-source Parametri

Parametro Alias Obbligatorio? Descrizione
--name <name> -n No Aggiornare un'origine dati specifica. Omettere di aggiornare tutte le origini associate.

Sviluppare localmente

Utilizza questi comandi per eseguire l'app localmente con il server di configurazione per lo sviluppo iterativo.

ms app dev

Avvia l'intero ciclo di sviluppo locale.

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

L'interfaccia della riga di comando avvia il processo di sviluppo del progetto insieme a un server di configurazione locale. L'URL di riproduzione viene stampato quando entrambi sono raggiungibili. Premi Ctrl+C per fermarli in modo pulito.

ms app dev Parametri

Parametro Alias Obbligatorio? Descrizione
--port <n> -p No Porta per il server di configurazione. Il valore predefinito è 8080.
--local-app-url <url> -l No URL in cui è raggiungibile il server di sviluppo. Il valore predefinito è http://localhost:3000.
--config-only -C No Avviare solo il server di configurazione, per quando si esegue il server di sviluppo separatamente (ad esempio, in un gestore di processi).

Compilare e distribuire

Usa questi comandi per creare pacchetti in locale, eseguire compilazioni remote e distribuire un commit convalidato.

ms app pack

Crea l'app localmente e prepara l'output per l'ispezione senza caricarlo da nessuna parte.

ms app pack

Usare questo comando per verificare che una compilazione locale pulita abbia esito positivo prima di attivare una compilazione remota.


ms app build

Attivare una build della piattaforma per un commit specifico in un'app supportata da Git.

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

ms app build Parametri

Parametro Alias Obbligatorio? Descrizione
--app <name> No Nome dell'app. L'impostazione predefinita da ms.config.json quando presente.
--commit <sha> -c No Impegnati a costruire. Il valore predefinito è l'attuale HEAD.
--no-wait No Torna immediatamente dopo l'invio e stampa un suggerimento con cui eseguire il ms app build-statusfollow-up. Per impostazione predefinita, il comando attende che la compilazione raggiunga uno stato terminale.
--open-browser No Avvia il browser di sistema se è necessaria una nuova autenticazione del flusso del codice del dispositivo per repository GitHub esterni. Non ha alcun effetto con --json.
--force-reauth No Ignora il mapping GitHub memorizzato e forza il flusso del codice del dispositivo. Riguarda solo le app associate a un repository GitHub esterno.

ms app build-status

Controllare lo stato di una build.

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

Se la compilazione non è riuscita, l'output include il motivo per cui è possibile correggere il codice ed eseguire di nuovo il push.

ms app build-status Parametri

Parametro Alias Obbligatorio? Descrizione
--app <name> No App da ispezionare. L'impostazione predefinita da ms.config.json quando presente.
--commit <sha> -c No Impegnati a controllare lo stato della build. Il valore predefinito è l'attuale HEAD.
--show-log No Recuperare e stampare il log di compilazione, se disponibile.

ms app deploy

Promuovi una build ecologica per l'app live.

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

Nota

  • Il comando viene distribuito nell'ambiente associato all'app. Non seleziona un ambiente di distribuzione.
  • Per le applicazioni supportate da Git, l'interfaccia della riga di comando risolve il commit (Git HEADlocale predefinito), mette in coda una build remota o riutilizza una build memorizzata nella cache per tale commit, attende il completamento e distribuisce lo stesso commit. Una compilazione non riuscita o annullata interrompe la distribuzione; l'interfaccia della riga di comando non seleziona una build riuscita meno recente.
  • Se il checkout ha modifiche non confermate o commit locali prima del remoto, la verifica preliminare chiede "Distribuire comunque?" in modalità interattiva. In modalità non interattiva o JSON, si interrompe con un errore di utilizzo, a meno che non si superi --force. Esegui il commit e invia le modifiche previste prima della distribuzione. --force bypassa il preflight; Non carica origine non approvata o non inviata.
  • Per le app senza controllo del codice sorgente (repoType: none), l'interfaccia della riga di comando comprime e carica la build locale o carica una predefinita .zip quando --artifact viene fornita.

ms app deploy Parametri

Parametro Alias Obbligatorio? Descrizione
--app <name> No App da distribuire. Le impostazioni predefinite di ms.config.json.
--commit <sha> -c No Commit per la distribuzione (solo app supportate da Git). Il valore predefinito è l'attuale HEAD. Si escludono a vicenda con --artifact.
--artifact <path> No Percorso di un artefatto di compilazione locale .zip da caricare e distribuire. Valido solo per le app create senza controllo del codice sorgente (repoType: none); rifiutate nelle app supportate da Git. Si escludono a vicenda con --commit.
--force No Ignora la conferma o il rifiuto del preflight Git per modifiche non confermate o commit locali prima del telecomando. Le modifiche non vengono caricate.
--open-browser No Avvia il browser di sistema se è necessaria una nuova autenticazione del flusso del codice del dispositivo. Non ha alcun effetto con --json.
--force-reauth No Ignora il mapping GitHub memorizzato e forza il flusso del codice del dispositivo. Riguarda solo le app associate a un repository GitHub esterno.

Fino al completamento della distribuzione, la distribuzione esistente rimane intatta e utilizzabile. Al termine della distribuzione, gli utenti finali visualizzano una notifica che indica che è disponibile una nuova versione con un collegamento per aggiornare l'app.

ms app deploy --artifact <path> Carica e distribuisce l'artefatto senza una compilazione gestita dalla piattaforma. La distribuzione di artefatti esterni non è consentita per impostazione predefinita. Consulta Distribuzione di artefatti esterni. L'organizzazione è responsabile della convalida degli artefatti compilati esternamente e della protezione della pipeline di compilazione prima della distribuzione.

Gioca

Usare questo comando per aprire l'app in modalità live o anteprima.

ms app play

Aprire un'app nel browser e stamparne l'URL di avvio.

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

ms app play Parametri

Parametro Alias Obbligatorio? Descrizione
--app <name> No App da aprire. Le impostazioni predefinite di ms.config.json.
--mode <mode> -m No live Apre l'app distribuita. preview apre il ramo Git corrente per impostazione predefinita o il ramo o il commit specificato. Il valore predefinito è live.
--commit <sha> -c No Apri l'anteprima con un commit specifico. Valido solo con --mode preview. Si escludono a vicenda con --branch.
--branch <name> No Apri l'anteprima per un ramo specifico. Valido solo con --mode preview. L'impostazione predefinita è il ramo Git corrente; se la CLI non è in grado di identificarlo, avvisa e ricade su main. Si escludono a vicenda con --commit.
--no-browser No Stampare l'URL di avvio senza aprire il browser predefinito. Utile per sessioni SSH, CI e script.

Nota

--mode live Avvisa che la build live è uno snapshot e non si aggiorna automaticamente. Esegui ms app deploy di nuovo per aggiornarlo. Se non è disponibile alcun URL di riproduzione, il comando non riesce. Se un URL esiste ma la destinazione non ha un commit distribuito, il comando avvisa e continua a stampare e aprire l'URL.

Comportamento della build di anteprima

In --mode preview, l'URL di avvio si basa sul commit nell'intestazione del ramo corrente o su un commit SHA selezionato. Ciò che viene visualizzato nel browser per quell'URL dipende dallo stato della build per quel commit:

Stato compilazione Comportamento di anteprima
L'ultimo commit ha una build riuscita Esegue il rendering della compilazione.
L'ultimo commit è ancora in fase di compilazione Esegue il rendering della build riuscita precedente con un banner in corso: "L'ultima build è in corso".
Compilazione dell'ultimo commit non riuscita Esegue il rendering della build riuscita precedente con un banner di errore: "Build più recente non riuscita. Mostrando l'ultima build riuscita".
L'app non ha ancora completato la compilazione Esegue il rendering di un'esperienza dedicata "mai distribuita".

Condividere

Usare questi comandi per concedere, revocare e gestire l'accesso alle app e i collegamenti di condivisione.

ms app share

Concedere l'accesso a utenti o gruppi.

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

Il comando cerca automaticamente gli indirizzi di posta elettronica. Segnala avvisi per le voci che non si risolvono, ma procede con quelle che lo fanno. Se nessuna voce viene risolta, il comando ha esito negativo.

ms app share Parametri

Parametro Alias Obbligatorio? Descrizione
<principals> Sì Elenco delimitato da virgole di indirizzi di posta elettronica o ID oggetto Microsoft Entra.
--app <name> No App da condividere. Le impostazioni predefinite di ms.config.json.
--access <level> No Concede l'accesso in fase di runtime (play, impostazione predefinita) o accesso come collaboratore (edit). L'accesso in modifica include i permessi del repository per Git gestito dalla piattaforma; l'accesso esterno al repository GitHub deve essere concesso separatamente in GitHub.

ms app unshare

Revoca l'accesso concesso in precedenza.

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

Il unshare comando influisce solo sul livello di accesso richiesto. Ad esempio, unshare --access edit lascia play intatto l'accesso. Le entità senza un'assegnazione di ruolo esistente al livello richiesto non possono partecipare.

Per le app supportate da GitHub, revocare separatamente l'accesso al repository esterno in GitHub. L'annullamento della condivisione dell'app non rimuove le autorizzazioni GitHub concesse in modo indipendente.

ms app unshare Parametri

Parametro Alias Obbligatorio? Descrizione
<principals> Sì Elenco delimitato da virgole di indirizzi di posta elettronica o ID oggetto Microsoft Entra.
--app <name> No App per annullare la condivisione. Le impostazioni predefinite di ms.config.json.
--access <level> No Revoca l'accesso in fase di runtime (play, predefinito) o come collaboratore (edit). L'accesso in modifica include le autorizzazioni del repository per Git gestito dalla piattaforma, ma non le autorizzazioni del repository GitHub esterno.

ms app share list

Elencare gli utenti e i gruppi con cui un'app è condivisa a un determinato livello di accesso.

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

ms app share list Parametri

Parametro Alias Obbligatorio? Descrizione
--access <level> Sì Livello di accesso all'elenco. ( play eseguire l'app) o edit (contribuire all'app). Per le app supportate da GitHub, questo elenco non stabilisce l'accesso al repository esterno.
--app <name> No App da ispezionare. Le impostazioni predefinite di ms.config.json.
--environment-id <id> -e No Sostituire l'ID ambiente. L'impostazione predefinita da ms.config.json quando presente.

Creare un collegamento di condivisione a livello di tenant per l'app.

ms app share link create [--app <name>] [--environment-id <id>]
Parametro Alias Obbligatorio? Descrizione
--app <name> No App da condividere. Le impostazioni predefinite di ms.config.json.
--environment-id <id> -e No Sostituire l'ID ambiente. L'impostazione predefinita da ms.config.json quando presente.

Collegamenti di condivisione elenco rilasciati per l'app.

ms app share link list [--app <name>] [--environment-id <id>]
Parametro Alias Obbligatorio? Descrizione
--app <name> No App da ispezionare. Le impostazioni predefinite di ms.config.json.
--environment-id <id> -e No Sostituire l'ID ambiente. L'impostazione predefinita da ms.config.json quando presente.

Revocare un collegamento di condivisione per ID. Questo comando rimuove ogni ruolo del riscattatore precedente prima di eliminare il record di collegamento.

ms app share link revoke --link-id <id> [--app <name>] [--environment-id <id>] [--force]
Parametro Alias Obbligatorio? Descrizione
--link-id <id> -l Sì L'ID del collegamento restituito da ms app share link create.
--app <name> No App proprietaria del collegamento. Le impostazioni predefinite di ms.config.json.
--environment-id <id> -e No Sostituire l'ID ambiente. L'impostazione predefinita da ms.config.json quando presente.
--force -f No Ignora la richiesta di conferma.

Ispezione e gestione

Usare questi comandi per visualizzare lo stato delle app, aggiornare le impostazioni e rimuovere le app quando necessario.

ms app list

Elenca tutte le app a cui puoi accedere. Per impostazione predefinita, il comando elenca tutte le app nel tenant. Usare --environment-id per limitare l'elenco a un singolo ambiente.

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

Restituisce i dettagli dell'app, ad esempio il nome visualizzato e l'ID app.

ms app list Parametri

Parametro Alias Obbligatorio? Descrizione
--environment-id <id> -e No Definire l'ambito dell'elenco in un singolo ambiente. Se omesso, il comando restituisce tutte le app a cui è possibile accedere nel tenant.
--permission <level> -p No Filtro delle autorizzazioni. Usa ( edit app a cui puoi contribuire) o play (app che puoi riprodurre o visualizzare). Senza distinzione tra maiuscole e minuscole.

ms app info

Mostra lo stato sul lato server dell'app.

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

Restituisce il nome visualizzato, la descrizione facoltativa, l'ID ambiente, l'ID app, l'ID progetto, il commit distribuito abbreviato in sette caratteri, i connettori e i dettagli facoltativi del repository. Non restituisce i proprietari o avvia URL.

Per ottenere URL di avvio senza aprire un browser, utilizza ms app play --no-browser per la modalità live o ms app play --mode preview --no-browser per la modalità anteprima. Aggiungi --json per un output strutturato. Per esaminare la configurazione locale effettiva, aprire ms.config.json; ms app info riporta lo stato del server.

ms app info Parametri

Parametro Alias Obbligatorio? Descrizione
--app <name> No Nome dell'app da controllare. Le impostazioni predefinite di ms.config.json. Passare un nome esplicito per esaminare un'app all'esterno della directory di lavoro corrente.
--environment-id <id> -e No Sostituire l'ID ambiente. Impostazioni predefinite da ms.config.json; quando non è impostato nessuno dei due, l'ambiente viene risolto automaticamente dal nome dell'app.

ms app get-settings

Mostra tutte le impostazioni dell'app e i loro valori correnti.

ms app get-settings

Scopri come visualizzare le impostazioni dell'app


ms app set-setting

Aggiorna una o più impostazioni dell'app.

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

Passare le impostazioni come contrassegni denominati. Vengono aggiornate solo le chiavi specificate.

ms app set-setting Parametri

Parametro Alias Obbligatorio? Descrizione
--show-header <bool> No Mostrare o nascondere la barra dell'intestazione dell'app.
[other-settings...] No Uno o più flag di impostazione denominati da aggiornare. Vengono modificate solo le chiavi fornite.

Informazioni su come configurare un'impostazione dell'app


ms app delete

Elimina l'app dall'ambiente. Questo comando non elimina il codice sorgente locale o il repository Git.

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

Se l'app non esiste, il comando viene terminato correttamente senza errori.

ms app delete Parametri

Parametro Alias Obbligatorio? Descrizione
--app <name> No App da eliminare. Le impostazioni predefinite di ms.config.json.
--environment-id <id> -e No Sostituire l'ID ambiente. Se omesso, l'ambiente viene risolto automaticamente dall'app. Utile per eliminare un'app dall'esterno della directory con scaffolding.
--force -f No Ignora la richiesta di conferma.

Amministrazione

Usare questi comandi per aggiungere o rimuovere proprietari delle app. Per una procedura dettagliata, vedere Riassegnare i proprietari delle app.

Nota

Questi comandi richiedono un repository Git gestito dalla piattaforma e autorizzazioni di amministratore Power Platform o amministratore globale.

ms admin add owner

Aggiungere uno o più proprietari dell'app senza rimuovere proprietari esistenti o modificare altre assegnazioni di ruolo.

ms admin add owner <principals...> --app <app-id> [--force]

ms admin add owner Parametri

Parametro Alias Obbligatorio? Descrizione
<principals...> Sì Uno o più indirizzi di posta elettronica o ID oggetto Microsoft Entra, separati da spazi o virgole. Per un'entità servizio, usare il relativo ID oggetto. Accetta fino a 100 entità univoche.
--app <app-id> Sì ID app in formato GUID. Deve essere fornito esplicitamente; non viene letto dalla configurazione locale. L'interfaccia della riga di comando rileva automaticamente l'ambiente dell'app.
--force -f No Ignora la richiesta di conferma. Non necessario quando si aggiungono proprietari in modalità JSON o non interattiva.

In modalità interattiva, il comando richiede conferma, a meno che non si specifichi --force. In modalità JSON o non interattiva, viene eseguito senza chiedere conferma.

Ad esempio, per aggiungere un secondo proprietario:

ms admin add owner newowner@contoso.com --app <app-id>

Per aggiungere più proprietari senza chiedere conferma:

ms admin add owner newowner@contoso.com backupowner@contoso.com --app <app-id> --force --json

ms admin remove owner

Rimuovere le assegnazioni del proprietario dell'app corrispondenti senza assegnare automaticamente un ruolo inferiore. Altre assegnazioni di ruolo, ad esempio l'accesso come collaboratore, rimangono invariate, quindi la persona potrebbe mantenere l'accesso tramite un altro ruolo.

ms admin remove owner <principals...> --app <app-id> [--force]

ms admin remove owner Parametri

Parametro Alias Obbligatorio? Descrizione
<principals...> Sì Uno o più indirizzi di posta elettronica o ID oggetto Microsoft Entra, separati da spazi o virgole. Per un'entità servizio, usare il relativo ID oggetto. Accetta fino a 100 entità univoche.
--app <app-id> Sì ID app in formato GUID. Deve essere fornito esplicitamente; non viene letto dalla configurazione locale. L'interfaccia della riga di comando rileva automaticamente l'ambiente dell'app.
--force -f Condizionale Ignora la richiesta di conferma. Obbligatorio con --json o --non-interactive. Non elude l'autorizzazione o la protezione dell'ultimo proprietario.

In modalità interattiva, il comando richiede conferma, a meno che non si specifichi --force. Se non viene trovata alcuna assegnazione del proprietario corrispondente, il comando ha esito positivo senza rimuovere nulla. Se la corrispondenza tramite posta elettronica non trova l'attività, riprova con l'ID oggetto Microsoft Entra della persona.

Ad esempio, per rimuovere un proprietario:

ms admin remove owner formerowner@contoso.com --app <app-id>

Per rimuovere un proprietario nell'automazione:

ms admin remove owner <object-id> --app <app-id> --force --json

Importante

Prima di rimuovere un proprietario, verificare che un altro proprietario possa gestire l'app. Quando si riassegna la proprietà, aggiungere e verificare prima il proprietario sostitutivo. La piattaforma impedisce di rimuovere l'ultimo proprietario dell'app. --force Salta solo la conferma.

I risultati segnalano attività rimosse, entità senza corrispondenza e assegnazioni ignorate. Esamina il risultato anziché presumere che tutti i proprietari richiesti siano stati rimossi. Se una richiesta ha esito negativo, controllare le assegnazioni correnti prima di riprovare perché alcune modifiche potrebbero essere già state applicate.

Telemetria

Per impostazione predefinita, l'interfaccia della riga di comando invia dati di telemetria anonimi. Usare questi comandi per controllare la raccolta.


ms telemetry enable

Attivare la raccolta di dati di telemetria.

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

ms telemetry enable Parametri

Parametro Alias Obbligatorio? Descrizione
--remote No Controlla l'invio dei dati di telemetria al servizio remoto. Questa opzione è l'impostazione predefinita quando non viene assegnato alcun contrassegno.
--console No Stampare gli eventi di telemetria nella console locale.

Passa entrambe le bandiere per attivare o disattivare entrambi i bersagli contemporaneamente.


ms telemetry disable

Disattiva la raccolta dei dati di telemetria.

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

ms telemetry disable Parametri

Parametro Alias Obbligatorio? Descrizione
--remote No Interrompere l'invio dei dati di telemetria al servizio remoto. Questa opzione è l'impostazione predefinita quando non viene assegnato alcun contrassegno.
--console No Interrompere la stampa degli eventi di telemetria nella console locale.

Passa entrambi i flag per disabilitare entrambi i bersagli contemporaneamente.


ms telemetry status

Mostra le impostazioni correnti della telemetria.

ms telemetry status