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.
Usare le variabili di ambiente per configurare Power Apps'autenticazione dell'interfaccia della riga di comando e fornire opzioni di comando negli script e nelle pipeline CI/CD. Le variabili di ambiente definite dall'interfaccia della riga di comando di Power Apps usano il PA_CLI_ prefisso .
Note
Le variabili di ambiente sono valori denominati resi disponibili dal sistema operativo alle applicazioni. Power Apps'interfaccia della riga di comando riconosce le variabili descritte in questo riferimento. Per informazioni sul funzionamento delle variabili di ambiente e su come gestirle, vedere Variabili di ambiente.
Questo riferimento descrive le variabili di ambiente del sistema operativo che configurano l'interfaccia della riga di comando di Power Apps. Queste variabili sono diverse dalle variabili di ambiente della soluzione Power Platform, che archiviano i valori di configurazione usati da un'app.
Per un'opzione di comando, l'interfaccia della riga di comando risolve un valore in questo ordine:
- Opzione della riga di comando
- Variabile di ambiente
- Valore predefinito, se l'opzione ha una
- Prompt interattivo, se supportato
Un'opzione fornita nella riga di comando ha la precedenza sulla variabile di ambiente corrispondente.
Importante
Le variabili di ambiente possono esporre segreti ad altri processi, log o cronologia della shell. Archiviare PA_CLI_SP_CLIENT_SECRET nell'archivio segreto della piattaforma CI/CD, mascherarlo dai log e non eseguire il commit dei segreti nel controllo del codice sorgente.
Impostare le variabili di ambiente
Gli esempi seguenti vengono impostati PA_CLI_ENVIRONMENT_ID prima di eseguire un comando dell'interfaccia della riga di comando di Power Apps.
$env:PA_CLI_ENVIRONMENT_ID = "<environment-id>"
pa app list
La variabile di ambiente rimane disponibile per i comandi avviati dalla stessa sessione del terminale. Usare il comando standard della shell per rimuoverlo quando non è più necessario.
Authentication
| Variabile di ambiente | Description |
|---|---|
PA_CLI_ACCOUNT |
Specifica l'account per pa auth login o pa auth switch. |
PA_CLI_SP_CLIENT_ID |
Specifica l'ID applicazione (client) Microsoft Entra per l'autenticazione dell'entità servizio. |
PA_CLI_SP_CLIENT_SECRET |
Specifica il segreto client per l'autenticazione dell'entità servizio. |
PA_CLI_SP_TENANT_ID |
Specifica l'ID della directory (tenant) Microsoft Entra per l'autenticazione dell'entità servizio. |
PA_CLI_USE_SP_AUTH |
Impostare il valore su true (minuscolo) per usare l'autenticazione dell'entità servizio. |
Le tre PA_CLI_SP_* variabili delle credenziali sono necessarie quando è selezionata l'autenticazione dell'entità servizio. Anche se CI=true seleziona anche l'autenticazione dell'entità servizio per la compatibilità, usare PA_CLI_USE_SP_AUTH=true per rendere esplicita la modalità di autenticazione.
Per istruzioni sull'installazione, vedere Pubblicare app di codice Power Apps con un'entità servizio.
Opzioni di comando globali
Queste variabili corrispondono alle opzioni disponibili tra i comandi dell'interfaccia della riga di comando di Power Apps.
| Variabile di ambiente | Opzione corrispondente | Description |
|---|---|---|
PA_CLI_CLOUD |
--cloud |
Seleziona il cloud di destinazione. I valori validi sono: - public (predefinito)- usgov- usgovhigh- usgovdod- chinaI valori non fanno distinzione tra maiuscole e minuscole. |
PA_CLI_ENVIRONMENT_ID |
--environment-id |
Specifica l'ID dell'ambiente Power Platform di destinazione. |
Inizializzazione dell'app
Queste variabili forniscono opzioni a pa app init.
| Variabile di ambiente | Opzione corrispondente | Description |
|---|---|---|
PA_CLI_APP_BUILD_PATH |
--build-path |
Specifica la directory di output di compilazione. Il valore predefinito è ./dist. |
PA_CLI_APP_DESCRIPTION |
--description |
Specifica la descrizione dell'app. |
PA_CLI_APP_DISPLAY_NAME |
--display-name |
Specifica il nome visualizzato dell'app. |
PA_CLI_APP_FILE_ENTRY_POINT |
--file-entry-point |
Specifica il punto di ingresso HTML nell'output di compilazione. Il valore predefinito è index.html. |
PA_CLI_APP_TYPE |
--app-type |
Specifica il tipo di app. I valori validi sono: - CodeApp (predefinito)- MobileAppIl valore viene salvato in power.config.json e usato come tipo di app quando l'app viene pubblicata. |
PA_CLI_APP_URL |
--app-url |
Specifica l'URL dell'app locale durante pa app init. Il valore viene salvato come localAppUrl in power.config.json e diventa l'URL predefinito per i comandi futuri pa app run . Il valore predefinito è http://localhost:3000. |
Eseguire applicazioni
Queste variabili forniscono opzioni a pa app run.
| Variabile di ambiente | Opzione corrispondente | Description |
|---|---|---|
PA_CLI_LOCAL_APP_URL |
--local-app-url |
Esegue l'override del localAppUrl valore da power.config.json per il comando corrente senza modificare la configurazione salvata. Se nessuno dei due valori è impostato, il valore predefinito è http://localhost:3000. |
PA_CLI_PORT |
--port |
Specifica la porta per l'host locale Power Apps. Il valore predefinito è 8080. |
Condividere app
Queste variabili forniscono opzioni a pa app share.
| Variabile di ambiente | Opzione corrispondente | Description |
|---|---|---|
PA_CLI_SHARE_ACCESS |
--access |
Specifica il livello di accesso. I valori validi sono: - play (predefinito)- edit |
PA_CLI_SHARE_PRINCIPAL |
--principal |
Specifica uno o più indirizzi di posta elettronica delimitati da virgole o ID oggetto Microsoft Entra. |
Soluzioni, connettori e origini dati
| Variabile di ambiente | Opzione corrispondente | Description |
|---|---|---|
PA_CLI_CONNECTION_DISPLAY_NAME |
--display-name |
Specifica il nome visualizzato durante la creazione di una connessione. |
PA_CLI_CONNECTION_ID |
--connection-id |
Specifica un ID istanza di connessione connettore. |
PA_CLI_CONNECTION_REF |
--connection-ref |
Specifica un nome logico di riferimento alla connessione. |
PA_CLI_CONNECTION_SEARCH |
--search |
Filtra i risultati da pa connection list. |
PA_CLI_CONNECTOR |
--connector |
Specifica un ID connettore, ad esempio shared_office365users. |
PA_CLI_CONNECTOR_SEARCH |
--search |
Filtra i risultati da pa connector list. |
PA_CLI_DATASET |
--dataset |
Specifica un set di dati, ad esempio un sito SharePoint o un database SQL. |
PA_CLI_DATA_SOURCE_NAME |
--name |
Specifica l'origine dati da aggiornare o rimuovere. |
PA_CLI_ORG_URL |
--org-url |
Esegue l'override dell'URL dell'organizzazione dataverse usato per recuperare i metadati quando si aggiunge un'origine dati. |
PA_CLI_PROCEDURE |
--procedure |
Specifica una stored procedure SQL. |
PA_CLI_SOLUTION_ID |
--solution-id |
Specifica la soluzione per pa app push, pa app add data-sourceo pa connection list-references. |
PA_CLI_SOLUTION_SEARCH |
--search |
Filtra i risultati da pa solution list. |
PA_CLI_TABLE |
--table |
Specifica un nome di risorsa della tabella o del connettore. |
Per i comandi che accettano ogni opzione, vedere le informazioni di riferimento sui comandi dell'interfaccia della riga di comando Power Apps.
API e flussi di Power Automate dataverse
| Variabile di ambiente | Opzione corrispondente | Description |
|---|---|---|
PA_CLI_DATAVERSE_API_NAME |
--api-name |
Specifica l'azione o la funzione Dataverse da aggiungere con pa app add dataverse-api. |
PA_CLI_DATAVERSE_API_SEARCH_TERM |
--search |
Filtra le azioni e le funzioni di Dataverse in base al nome con pa app find-dataverse-api. |
PA_CLI_FLOW_DATA_SOURCE_NAME |
--flow-name |
Specifica l'origine dati del flusso da rimuovere dall'app con pa app remove flow |
PA_CLI_FLOW_ID |
--flow-id |
Specifica il flusso di Power Automate da aggiungere con pa app add flow. |
PA_CLI_FLOW_SEARCH |
--search |
Filtra i flussi di Power Automate disponibili in base al nome conpa app list-flows |
PA_CLI_REMOVE_FLOW_ID |
--flow-id |
Specifica il flusso di Power Automate da rimuovere conpa app remove flow |
Telemetria e output della console
| Variabile di ambiente | Opzione corrispondente | Description |
|---|---|---|
PA_CLI_CONSOLE_ONLY |
--console-only |
Impostare il valore su true (minuscolo) con pa telemetry enable o pa telemetry disable per scrivere i dati di telemetria solo nella console e non inviarli in remoto. |
PA_CLI_OUTPUT_TO_CONSOLE |
--output-to-console |
Impostare il valore su true (minuscolo) con pa telemetry enable o pa telemetry disable per eseguire il mirroring degli eventi di telemetria inviati in remoto alla console. |
PA_CLI_TELEMETRY |
None | Impostare uno di questi valori per disabilitare i dati di telemetria per il processo corrente: - 0- false- no- offI valori non fanno distinzione tra maiuscole e minuscole e gli spazi circostanti vengono ignorati. |
Per le impostazioni di telemetria persistenti, vedere Gestire le impostazioni di telemetria per l'interfaccia della riga di comando di Power Apps.
Variabili di ambiente standard
L'interfaccia della riga di comando osserva anche questa variabile di ambiente standard:
| Variabile di ambiente | Description |
|---|---|
NO_COLOR |
Impostare questa variabile su un valore non vuoto per disabilitare l'output del colore ANSI. È anche possibile usare l'opzione --no-color . |