CLI ortam değişkenlerini Power Apps

Power Apps CLI kimlik doğrulamasını yapılandırmak ve betiklerde ve CI/CD işlem hatlarında komut seçenekleri sağlamak için ortam değişkenlerini kullanın. Power Apps CLI tarafından tanımlanan ortam değişkenleri ön ekini PA_CLI_ kullanır.

Note

Ortam değişkenleri, işletim sisteminin uygulamalar için kullanılabilir hale getirdiği adlandırılmış değerlerdir. Power Apps CLI, bu başvuruda açıklanan değişkenleri tanır. Ortam değişkenlerinin nasıl çalıştığını ve bunların nasıl yönetileceğini öğrenmek için Ortam Değişkenleri hakkında bilgi edinin.

Bu başvuru, Power Apps CLI'yi yapılandıran işletim sistemi ortam değişkenlerini açıklar. Bu değişkenler, bir uygulama tarafından kullanılan yapılandırma değerlerini depolayan Power Platform çözümü ortam değişkenlerinden farklıdır.

Bir komut seçeneği için, CLI bir değeri şu sırayla çözümler:

  1. Komut satırı seçeneği
  2. Ortam değişkeni
  3. Seçeneğin bir değeri varsa varsayılan değer
  4. Desteklendiğinde etkileşimli istem

Komut satırında sağlanan bir seçenek, ilgili ortam değişkenine göre önceliklidir.

Important

Ortam değişkenleri gizli dizileri diğer işlemlere, günlüklere veya kabuk geçmişine gösterebilir. CI/CD platformunuzun gizli dizi deposunda depolayın PA_CLI_SP_CLIENT_SECRET , günlüklerden maskeleyin ve gizli dizileri kaynak denetimine işlemeyin.

Ortam değişkenlerini ayarlama

Aşağıdaki örnekler, Power Apps CLI komutunu çalıştırmadan önce ayarlanırPA_CLI_ENVIRONMENT_ID.

$env:PA_CLI_ENVIRONMENT_ID = "<environment-id>"
pa app list

Ortam değişkeni aynı terminal oturumundan başlatılan komutlar için kullanılabilir durumda kalır. Artık gerekli olmadığında kabuğunuzu kaldırmak için standart komutunu kullanın.

Kimlik Doğrulaması

Ortam değişkeni Description
PA_CLI_ACCOUNT veya pa auth switchiçin pa auth login hesabı belirtir.
PA_CLI_SP_CLIENT_ID Hizmet sorumlusu kimlik doğrulaması için Microsoft Entra uygulama (istemci) kimliğini belirtir.
PA_CLI_SP_CLIENT_SECRET Hizmet sorumlusu kimlik doğrulaması için istemci gizli dizisini belirtir.
PA_CLI_SP_TENANT_ID Hizmet sorumlusu kimlik doğrulaması için Microsoft Entra dizin (kiracı) kimliğini belirtir.
PA_CLI_USE_SP_AUTH Hizmet sorumlusu kimlik doğrulamasını kullanmak için değeri true (küçük harf) olarak ayarlayın.

Hizmet sorumlusu kimlik doğrulaması seçildiğinde üç PA_CLI_SP_* kimlik bilgisi değişkeni gerekir. Uyumluluk için hizmet sorumlusu kimlik doğrulamasını da seçse CI=true de, kimlik doğrulama modunu açık hale getirmek için kullanın PA_CLI_USE_SP_AUTH=true .

Kurulum yönergeleri için bkz. Hizmet sorumlusuyla Power Apps kod uygulamaları yayımlama.

Genel komut seçenekleri

Bu değişkenler, Power Apps CLI komutlarında kullanılabilen seçeneklere karşılık gelir.

Ortam değişkeni Karşılık gelen seçenek Description
PA_CLI_CLOUD --cloud Hedef bulutu seçer. Geçerli değerler şunlardır:
- public (varsayılan)
- usgov
- usgovhigh
- usgovdod
- china
Değerler büyük/küçük harfe duyarlı değildir.
PA_CLI_ENVIRONMENT_ID --environment-id Hedef Power Platform ortam kimliğini belirtir.

Uygulama başlatma

Bu değişkenler için pa app initseçenekleri sağlar.

Ortam değişkeni Karşılık gelen seçenek Description
PA_CLI_APP_BUILD_PATH --build-path Derleme çıktı dizinini belirtir. Varsayılan değer: ./dist.
PA_CLI_APP_DESCRIPTION --description Uygulama açıklamasını belirtir.
PA_CLI_APP_DISPLAY_NAME --display-name Uygulama görünen adını belirtir.
PA_CLI_APP_FILE_ENTRY_POINT --file-entry-point Derleme çıkışındaki HTML giriş noktasını belirtir. Varsayılan değer: index.html.
PA_CLI_APP_TYPE --app-type Uygulama türünü belirtir. Geçerli değerler şunlardır:
- CodeApp (varsayılan)
- MobileApp
Değeri içinde kaydedilir power.config.json ve uygulama yayımlandığında uygulama türü olarak kullanılır.
PA_CLI_APP_URL --app-url sırasında pa app inityerel uygulama URL'sini belirtir. değeri içinde power.config.json olarak localAppUrl kaydedilir ve gelecekteki pa app run komutlar için varsayılan URL'ye dönüşür. Varsayılan değer: http://localhost:3000.

Uygulamaları çalıştırma

Bu değişkenler için pa app runseçenekleri sağlar.

Ortam değişkeni Karşılık gelen seçenek Description
PA_CLI_LOCAL_APP_URL --local-app-url Kaydedilen yapılandırmayı localAppUrl değiştirmeden geçerli komut için değerini power.config.json geçersiz kılar. Her iki değer de ayarlı değilse, varsayılan değer olur http://localhost:3000.
PA_CLI_PORT --port Power Apps yerel konağın bağlantı noktasını belirtir. Varsayılan değer: 8080.

Uygulamaları paylaşma

Bu değişkenler için pa app shareseçenekleri sağlar.

Ortam değişkeni Karşılık gelen seçenek Description
PA_CLI_SHARE_ACCESS --access Erişim düzeyini belirtir. Geçerli değerler şunlardır:
- play (varsayılan)
- edit
PA_CLI_SHARE_PRINCIPAL --principal Bir veya daha fazla virgülle ayrılmış e-posta adresi veya Microsoft Entra nesne kimliklerini belirtir.

Çözümler, bağlayıcılar ve veri kaynakları

Ortam değişkeni Karşılık gelen seçenek Description
PA_CLI_CONNECTION_DISPLAY_NAME --display-name Bağlantı oluştururken görünen adı belirtir.
PA_CLI_CONNECTION_ID --connection-id Bağlayıcı bağlantı örneği kimliğini belirtir.
PA_CLI_CONNECTION_REF --connection-ref Bağlantı başvurusu mantıksal adını belirtir.
PA_CLI_CONNECTION_SEARCH --search 'den pa connection listsonuçları filtreler.
PA_CLI_CONNECTOR --connector gibi shared_office365usersbir bağlayıcı kimliği belirtir.
PA_CLI_CONNECTOR_SEARCH --search 'den pa connector listsonuçları filtreler.
PA_CLI_DATASET --dataset SharePoint sitesi veya SQL veritabanı gibi bir veri kümesini belirtir.
PA_CLI_DATA_SOURCE_NAME --name Yenilenmesi veya kaldırılması gereken veri kaynağını belirtir.
PA_CLI_ORG_URL --org-url Veri kaynağı eklerken meta verileri almak için kullanılan Dataverse kuruluş URL'sini geçersiz kılar.
PA_CLI_PROCEDURE --procedure SQL saklı yordamını belirtir.
PA_CLI_SOLUTION_ID --solution-id , pa app add data-sourceveya pa connection list-referencesiçin pa app pushçözümü belirtir.
PA_CLI_SOLUTION_SEARCH --search 'den pa solution listsonuçları filtreler.
PA_CLI_TABLE --table Bir tablo veya bağlayıcı kaynak adı belirtir.

Her seçeneği kabul eden komutlar için Power Apps CLI komut başvurusuna bakın.

Dataverse API'leri ve Power Automate akışları

Ortam değişkeni Karşılık gelen seçenek Description
PA_CLI_DATAVERSE_API_NAME --api-name pa app add dataverse-api ile eklenecek Dataverse eylemini veya işlevini belirtir.
PA_CLI_DATAVERSE_API_SEARCH_TERM --search Dataverse eylemlerini ve işlevlerini ile pa app find-dataverse-apiada göre filtreler.
PA_CLI_FLOW_DATA_SOURCE_NAME --flow-name ile uygulamadan kaldırılacak akış veri kaynağını belirtir pa app remove flow
PA_CLI_FLOW_ID --flow-id ile pa app add floweklenecek Power Automate akışını belirtir.
PA_CLI_FLOW_SEARCH --search Kullanılabilir Power Automate akışlarını ada göre filtrelerpa app list-flows
PA_CLI_REMOVE_FLOW_ID --flow-id ile kaldırılacak Power Automate akışını belirtirpa app remove flow

Telemetri ve konsol çıkışı

Ortam değişkeni Karşılık gelen seçenek Description
PA_CLI_CONSOLE_ONLY --console-only Telemetriyi yalnızca konsola true yazmak ve uzaktan göndermemek için değerini veya ile pa telemetry enablepa telemetry disable (küçük harf) olarak ayarlayın.
PA_CLI_OUTPUT_TO_CONSOLE --output-to-console Uzaktan gönderilen telemetri olaylarını konsola true yansıtmak için veya ile pa telemetry enablepa telemetry disable değerini (küçük harf) olarak ayarlayın.
PA_CLI_TELEMETRY Hiçbiri Geçerli işlem için telemetriyi devre dışı bırakmak için şu değerlerden birini ayarlayın:
- 0
- false
- no
- off
Değerler büyük/küçük harfe duyarlı değildir ve çevresindeki boşluklar yoksayılır.

Kalıcı telemetri ayarları için bkz. Power Apps CLI için telemetri ayarlarını yönetme.

Standart ortam değişkenleri

CLI ayrıca şu standart ortam değişkenini de gözlemler:

Ortam değişkeni Description
NO_COLOR ANSI renk çıkışını devre dışı bırakmak için bu değişkeni boş bir değere ayarlayın. Seçeneğini de kullanabilirsiniz --no-color .
  • Last updated on