Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
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 scrivems.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 createeseguire 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
--asin 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.--forcebypassa 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.zipquando--artifactviene 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. |
ms app share link create
Creare un collegamento di condivisione a livello di tenant per l'app.
ms app share link create [--app <name>] [--environment-id <id>]
ms app share link create Parametri
| 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. |
ms app share link list
Collegamenti di condivisione elenco rilasciati per l'app.
ms app share link list [--app <name>] [--environment-id <id>]
ms app share link list Parametri
| 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. |
ms app share link revoke
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]
ms app share link revoke Parametri
| 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