Microsoft Power Platform Build Tools görevleri

  • Makale

Kullanılabilir yapı görevleri aşağıdaki bölümlerde açıklanmaktadır. Daha sonra bu görevlerin kullanıldığı bazı örnek Azure Pipelines göstereceğiz. Derleme araçları ve bunların nasıl indirileceği ile ilgili bilgi için bkz. Azure Pipelines için Microsoft Power Platform Derleme Araçları.

Yardımcı görev

Kullanılabilir yardımcı görevler aşağıda açıklanmıştır.

Power Platform Aracı Yükleyicisi

Bu görevin derleme ve yayınlama ardışık düzenlerindeki tüm diğer Power Platform Build Tools görevlerinden önce bir kez eklenmesi gerekir. Bu görev, Microsoft Power Platform derleme görevlerini çalıştırmak için aracının gerektirdiği belirli Power Platform araçlar kümesini yükler. Bu görev eklenirken daha fazla yapılandırma gerektirmez. Bu, görev yüklenmekte olan her aracın belirli sürümleri için parametreleri içerir.

Zaman içinde araç sürümlerinde güncel kalmak için, bu parametrelerin, ardışık düzenin düzgün çalışması için gerekli olan araçların sürümlerine uygun olduğundan emin olun.

YAML kod parçacığı (Yükleyici)

# Installs default Power Platform Build Tools
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.tool-installer.PowerPlatformToolInstaller@0
  displayName: 'Power Platform Tool Installer'

# Installs specific versions of the Power Platform Build Tools
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.tool-installer.PowerPlatformToolInstaller@0
  displayName: 'Power Platform Tool Installer'
  inputs:
    DefaultVersion: false
    XrmToolingPackageDeploymentVersion: 3.3.0.928

Parametreler (Yükleyici)

Parametreler Açıklama
DefaultVersion
Varsayılan araç sürümlerini kullanma		 Tüm araçların varsayılan sürümünü kullanmak için doğru aksi takdirde yanlış değerine ayarlayın. Herhangi bir araç sürümü belirtildiğinde gerekli (ve yanlış).
PowerAppsAdminVersion
XrmToolingPackageDeploymentVersion
MicrosoftPowerAppsCheckerVersion
CrmSdkCoreToolsVersion
Araç sürümü		 Kullanılacak aracın belirli sürümü.

Power Platform WhoAmI

Bir WhoAmI isteğine bağlanarak ve böyle bir istek göndererek Power Platform ortam hizmeti bağlantısını doğrular. İşleme başlamadan önce bağlanabilirliği doğrulamak amacıyla bu görevin, ardışık düzenin erken aşamalarında eklenmesi yararlı olabilir.

YAML kod parçacığı (WhoAmI)

# Verifies an environment service connection
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.whoami.PowerPlatformWhoAmi@0
  displayName: 'Power Platform WhoAmI'

  inputs: 
#   Service Principal/client secret (supports MFA)
    authenticationType: PowerPlatformSPN
    PowerPlatformSPN: 'My service connection'

# Verifies an environment service connection
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.whoami.PowerPlatformWhoAmi@0
  displayName: 'Power Platform WhoAmI'

  inputs:
#   Username/password (no MFA support)
    PowerPlatformEnvironment: 'My service connection'

Parametreler (WhoAmI)

Parametreler Açıklama
authenticationType
Kimlik doğrulaması türü		 (İsteğe bağlı) Kullanıcı adı/parola bağlantısı için PowerPlatformEnvironment veya Hizmet Sorumlusu/istemcisi gizli anahtarı bağlantısı için PowerPlatformSPN'yi belirtin. Daha fazla bilgi: bkz. Power Platform Ortam Oluştur altındaki BuildTools.EnvironmentUrl
PowerPlatformEnvironment
Power Platform ortam URL‘si		 İçine kopyalanacak ortam için hizmet uç noktası. Bu, Proje Ayarları içinde Servis Bağlantıları altında tanımlıdır. Daha fazla bilgi: bkz. Power Platform Ortam Oluştur altındaki BuildTools.EnvironmentUrl
PowerPlatformSPN
Power Platform Hizmet Sorumlusu		 İçine kopyalanacak ortam için hizmet uç noktası. Bu, Proje Ayarları içinde Servis Bağlantıları altında tanımlıdır.

Kalite denetimi

Sonraki bölümde, bir çözümün kalitesini kontrol etmek için kullanılabilecek görevler yer almaktadır.

Power Platform Checker

Bu görev, çözümünüzü oluştururken istemeden sunulan sorunlu modelleri belirlemek için en iyi uygulama kuralları kümesine karşı çözümlerinizde statik bir çözümleme denetimi çalıştırır.

YAML kod parçacığı (Denetleyici)

# Static analysis check of your solution
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.checker.PowerPlatformChecker@0
  displayName: 'Power Platform Checker '
  inputs:
    PowerPlatformSPN: 'Dataverse service connection'
    RuleSet: '0ad12346-e108-40b8-a956-9a8f95ea18c9'

# Static analysis check of your solution
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.checker.PowerPlatformChecker@0
  displayName: 'Power Platform Checker '
  inputs:
    PowerPlatformSPN: 'Dataverse service connection'
    UseDefaultPACheckerEndpoint: false
    CustomPACheckerEndpoint: 'https://japan.api.advisor.powerapps.com/'
    FileLocation: sasUriFile
    FilesToAnalyzeSasUri: 'SAS URI'
    FilesToAnalyze: '**\*.zip'
    FilesToExclude: '**\*.tzip'
    RulesToOverride: 'JSON array'
    RuleSet: '0ad12346-e108-40b8-a956-9a8f95ea18c9'

Parametreler (Denetleyici)

Parametreler Açıklama
PowerPlatformSPN
Hizmet bağlantıları		 (Gerekli) Power Platform Denetleyiciyi kullanmak için lisanslı bir Microsoft Power Platform ortama bağlantı gerekir . Hizmet bağlantıları, Power Platform bağlantı türünü kullanarak proje ayarları altındaki hizmet bağlantılarında tanımlanır . Daha fazla bilgi için bkz. Power Platform Ortam Oluşturma altında BuildTools.EnvironmentUrl

Not: Denetleyici görevi için Hizmet Sorumlusu ve kullanıcı adı/parola kimlik doğrulama yöntemleri kullanılabilir. Bu görevle kullanılacak servis ilkelerini yapılandırma hakkında Daha fazla bilgi edinmek için bkz. Power Platform ortamlar için hizmet sorumlusu bağlantılarını yapılandırma.
UseDefaultPACheckerEndpoint
Varsayılan Power Platform Denetleyici uç noktasını kullanma		 Varsayılan olarak (true) denetleyici servisinin coğrafi konumu, bağlandığınız ortamla aynı coğrafi bölgeyi kullanır.
CustomPACheckerEndpoint
Özel PAC denetleyicisi uç noktası		 UseDefaultPACheckerEndpointyanlış olduğunda gereklidir. Kullanılacak başka bir coğrafi konum belirtebilirsiniz; örneğin https://japan.api.advisor.powerapps.com.Mevcut coğrafi konumların listesi için bkz Power Platform Checker API'sini kullanma.
FileLocation
Çözümlenecek dosyaların konumu		 Paylaşılan erişim imzası (SAS) URL'sinden sasUriFile bir dosyaya başvurulurken gereklidir.

Not: Deponuzdaki paketlenmemiş kaynak dosyalara değil, dışarı aktarılmış bir çözüm dosyasına başvurmak önemlidir. Hem yönetilen, hem de yönetilmeyen çözüm dosyaları analiz edilebilir.
FilesToAnalyzeSasUri
Analiz edilecek SAS dosyaları		 FileLocationsasUriFile olarak ayarlandığında gereklidir. SAS URI'sini girin. Bir virgül (,) veya noktalı virgülle (;) ayrılmış liste daha fazla SAS URI'si ekleyebilirsiniz.
FilesToAnalyze
Analiz edilecek yerel dosyalar		 SAS dosyaları analiz edilmediğinde gerekir. Çözümlenecek ZIP dosyalarının yolunu ve dosya adını belirtin. Joker karakterler kullanılabilir. Örneğin, tüm alt klasörlerdeki tüm zip dosyaları için **\*.zip girin.
FilesToExclude
Hariç tutulacak yerel dosyalar		 Analizin dışında tutulacak dosyaların adlarını belirtin. Birden çok varsa, virgül (,) veya noktalı virgülle (;) ayrılmış bir listeye girin. Bu liste, tam dosya adı veya *jquery veya form.js gibi önde veya sonda bulunan joker karakterlere sahip bir ad içerebilir
RulesToOverride
Geçersiz kılınacak kurallar		 Geçersiz kılınacak kuralları ve düzeyleri içeren bir JSON dizisi. OverrideLevel için kabul edilen değerler şunlardır: Kritik, Yüksek, Orta, Düşük, Bilgilendirici. Örnek: [{"Id":"meta-remove-dup-reg","OverrideLevel":"Medium"},{"Id":"il-avoid-specialized-update-ops","OverrideLevel":"Medium"}]
RuleSet
Kural kümesi		 (Gerekli) Uygulanacak kural kümesini belirtin. Aşağıdaki iki kural kümesi kullanılabilir:
  • Çözüm denetleyicisi: Bu kural, Power Apps maker portalından çalıştırılan aynı kural kümesidir.
  • AppSource: AppSource uygulamasına yayınlanabilmesi için önce bir uygulamanın onayladıktan kullanılan genişletilmiş kural kümesidir.
ErrorLevel
Hata Düzeyi		 Hata eşiği parametresiyle birlikte, izin verilen hata ve uyarıların önem düzeyini tanımlar. Desteklenen eşik değerleri şunlardır: Düzeyin şunlardan biri olduğu <level>IssueCount = Kritik, Yüksek, Orta, Düşük ve Bilgilendirici.
ErrorThreshold
Hata eşiği		 Belirlenen düzeydeki, denetleyici tarafından denetlenen çözümlerin geçmesine izin verilen hata sayısını (>=0) tanımlar.
FailOnPowerAppsCheckerAnalysisError
Hata ile karşılaşıldığında başarısız yap		 Doğru olduğunda, Power Apps Denetleyici analizi Başarısız veya FinishedWithErrors olarak döndürülürse başarısız olur.
ArtifactDestinationName
DevOps yapıt adı		 Denetleyici .sarif dosyası için Azure Artifacts adını belirtin.

Çözüm görevleri

Bu görevler kümesi, çözüm eylemlerini otomatikleştirebilir. Bu bölümde daha sonra açıklanan ve bir ortam oluşturan, kopyalayan veya geri yükleyen ortam görevleri, yeni oluşturan ortamlarla servis bağlantılarının üzerine yazar. Bu görevler, isteğe bağlı olarak oluşturulan ortamlarda çözüm görevleri gerçekleştirmeye olanak sağlar.

Power Platform Çözümü İçeri Aktar

Hedef ortama bir çözüm alır.

YAML kod parçacığı (İçeri aktarma)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.import-solution.PowerPlatformImportSolution@0
  displayName: 'Power Platform Import Solution '
  inputs:
    PowerPlatformEnvironment: 'My service connection'
    SolutionInputFile: 'C:\Public\Contoso_sample_1_0_0_1_managed.zip'
    HoldingSolution: true
    OverwriteUnmanagedCustomizations: true
    SkipProductUpdateDependencies: true
    ConvertToManaged: true

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.import-solution.PowerPlatformImportSolution@0
  displayName: 'Power Platform Import Solution '
  inputs:
    authenticationType: PowerPlatformSPN
    PowerPlatformSPN: 'Dataverse service connection '
    SolutionInputFile: 'C:\Public\Contoso_sample_1_0_0_1_managed.zip'
    AsyncOperation: true
    MaxAsyncWaitTime: 60
    PublishWorkflows: false

Parametreler (İçeri aktarma)

Parametreler Açıklama
authenticationType
Kimlik doğrulaması türü		 (SPN için gereklidir) Kullanıcı adı/parola bağlantısı için PowerPlatformEnvironment veya Hizmet Sorumlusu/istemcisi gizli anahtarı bağlantısı için PowerPlatformSPN'yi belirtin.
PowerPlatformEnvironment
Power Platform ortam URL‘si		 Çözümü içeri aktarmak istediğiniz servis uç noktası (örneğin, https://powerappsbuildtools.crm.dynamics.com). Proje Ayarları'ndaki Hizmet Bağlantıları altında Power Platform bağlantı türü kullanılarak tanımlanır. Daha fazla bilgi: bkz. Power Platform Ortam Oluştur altındaki BuildTools.EnvironmentUrl
PowerPlatformSPN
Power Platform Hizmet Sorumlusu		 Çözümü içeri aktarmak istediğiniz servis uç noktası (örneğin, https://powerappsbuildtools.crm.dynamics.com). Proje Ayarları'ndaki Hizmet Bağlantıları altında Power Platform bağlantı türü kullanılarak tanımlanır. Daha fazla bilgi: bkz. Power Platform Ortam Oluştur altındaki BuildTools.EnvironmentUrl
SolutionInputFile
Çözüm giriş dosyası		 (Gerekli) Hedef ortama alınacak çözüm .zip dosyasının yolu ve dosya adı (örneğin $(Build.ArtifactStagingDirectory)$(SolutionName).zip).

Not: Değişkenler, ardışık düzenin çeşitli bölümlerine anahtar bitleri almak için kullanışlı bir yol sunar. Kapsamlı bir liste için bkz. Önceden tanımlanmış değişkenleri kullanma.
HoldingSolution
Bir saklama çözümü olarak al		 Çözüm yükseltilmesi gerektiğinde kullanılan bir ön parametre (true|false). Bu parametre, Dataverse uygulamasında çözümü barındırır ancak Çözüm Yükseltmesini Uygula görevi çalıştırılıncaya kadar çözümü yükseltmez.
OverwriteUnmanagedCustomizations
Yönetilmeyen özelleştirmelerin üzerine yaz		 Yönetilmeyen özelleştirmelerin üzerine yazılıp yazılmayacağını belirtin (true|false).
SkipProductUpdateDependencies
Ürün güncelleştirme bağımlılıklarını atla		 Ürün güncelleştirmeleriyle ilgili bağımlılıkların zorunlu kılmanın atlanıp atlanmaması gerektiğini belirtin (true|false).
ConvertToManaged
Yönetilene dönüştür		 Yönetilen çözüm olarak içeri aktarılıp aktarılmayacağını belirtin (true|false).
AsyncOperation
Zaman uyumsuz içeri aktarma		 Seçili ( doğru) ise, içeri aktarma işlemi zaman uyumsuz olarak gerçekleştirilir. Bu görev, 4 dakika sonra otomatik olarak zaman aşımına uğratıkça, daha büyük çözümler için bu önerilir. Zaman uyumsuz olarak seçilmesi yoklama yapar ve MaxAsyncWaitTime süresine ulaşılıncaya kadar bekler (true|false).
MaxAsyncWaitTime
Maksimum bekleme süresi		 Zaman uyumsuz işlem için dakika olarak maksimum bekleme süresi; görevler için Azure DevOps varsayılanı gibi varsayılan değer 60 dakikadır (1 sa).
PublishWorkflows
İçeri aktarma işleminden sonra işlemleri etkinleştir		 Çözümdeki herhangi bir işlemin (iş akışı), içeri aktarma işleminden sonra etkinleştirilmesi gerekip gerekmediğini belirtin (true|false).
UseDeploymentSettingsFile
Dağıtım ayarları dosyasını kullan		 Bağlantı başvuruları ve ortam değişkeni değerleri dağıtım ayarları dosyası (true|false) kullanılarak ayarlanabilir.
DeploymentSettingsFile
Dağıtım ayarları dosyası		 (UseDeploymentSettingsFile=doğru olduğunda gereklidir) Dağıtım ayarları dosyasının yolu ve dosya adı.

Power Platform Çözüm Bileşeni Ekleme

Yönetilmeyen bir çözüme çözüm bileşeni ekler.

YAML kod parçacığı (Ekle)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.add-solution-component.PowerPlatformAddSolutionComponent@2
  displayName: 'Power Platform Add Solution Component '
  inputs:
    authenticationType: PowerPlatformSPN
    PowerPlatformSPN: Build
    SolutionName: 'SampleSolution '
    Component: contact
    ComponentType: 1
    AddRequiredComponents: false

Parametreler (Ekle)

Parametreler Veri Akışı Açıklaması
ComponentId
Çözüm bileşeninin kimliği		 Hedef çözüme eklenecek bileşenin şema adı veya kimliği.
ComponentType
Power Platform ortam URL‘si		 Eklediğiniz çözüm bileşenini temsil eden değer. Bileşen değerlerinin kapsamlı bir listesi için bkz. Önceden tanımlı bileşen tipleri kullanma.
SolutionUniqueName
Çözümün adı		 Çözümün benzersiz adı.
AddRequiredComponents
Çözüm bileşenine bağlı diğer çözümlerden gereken tüm bileşenler		 (İsteğe Bağlı) Eklediğiniz çözüm bileşeninin gerektirdiği diğer çözüm bileşenlerinin de yönetilmeyen çözüme eklenmesi gerekip gerekmediğini belirtir.
Environment
Ortam URL'si veya kimliği		 (İsteğe Bağlı) Hedef ortamın ortam URL'si veya kimliği.

Power Platform Çözüm Yükseltmesini Uygula

Bir saklama çözümü olarak alınmış bir çözümü yükseltir.

YAML kod parçacığı (Yükseltme)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.apply-solution-upgrade.PowerPlatformApplySolutionUpgrade@0
  displayName: 'Power Platform Apply Solution Upgrade '
  inputs:
    PowerPlatformEnvironment: 'My service connection'
    SolutionName: 'Contoso_sample'
    AsyncOperation: false

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.apply-solution-upgrade.PowerPlatformApplySolutionUpgrade@0
  displayName: 'Power Platform Apply Solution Upgrade '
  inputs:
    authenticationType: PowerPlatformSPN
    PowerPlatformSPN: 'Dataverse service connection '
    SolutionName: 'Contoso_sample'
    MaxAsyncWaitTime: 45

Parametreler (Yükseltme)

Parametreler Açıklama
authenticationType
Kimlik doğrulaması türü		 (SPN için gereklidir) Kullanıcı adı/parola bağlantısı için PowerPlatformEnvironment veya Hizmet Sorumlusu/istemcisi gizli anahtarı bağlantısı için PowerPlatformSPN'yi belirtin.
PowerPlatformEnvironment
Power Platform ortam URL‘si		 Çözümü yükseltmek istediğiniz hizmet uç noktası (örneğin, https://powerappsbuildtools.crm.dynamics.com). Proje Ayarları'ndaki Hizmet Bağlantıları altında Power Platform bağlantı türü kullanılarak tanımlanır. Daha fazla bilgi: bkz. Power Platform Ortam Oluştur altındaki BuildTools.EnvironmentUrl
PowerPlatformSPN
Power Platform Hizmet Sorumlusu		 Çözümü yükseltmek istediğiniz hizmet uç noktası (örneğin, https://powerappsbuildtools.crm.dynamics.com). Proje Ayarları'ndaki Hizmet Bağlantıları altında Power Platform bağlantı türü kullanılarak tanımlanır. Daha fazla bilgi: bkz. Power Platform Ortam Oluştur altındaki BuildTools.EnvironmentUrl
SolutionName
Çözüm adı		 (Gerekli) Yükseltmenin uygulanacağı çözüm adı. Her zaman çözüm Adı kullanın Görünün Ad'ı değil.
AsyncOperation
Zaman uyumsuz yükseltme		 Seçili (doğru) ise, yükseltme işlemi zaman uyumsuz toplu iş olarak gerçekleştirilir. Zaman uyumsuz olarak seçilmesi yoklama yapar ve MaxAsyncWaitTime süresine ulaşılıncaya kadar bekler.
MaxAsyncWaitTime
Maksimum bekleme süresi		 Zaman uyumsuz işlem için dakika olarak maksimum bekleme süresi; görevler için Azure DevOps varsayılanı gibi varsayılan değer 60 dakikadır (1 sa).

Not

Değişkenler, ardışık düzenin çeşitli bölümlerine anahtar bitleri almak için kullanışlı bir yol sunar. Kapsamlı bir liste için bkz. Önceden tanımlanmış değişkenleri kullanma. Dağıtım ayarları dosyasını kullanarak bir çözüm alırken hedef ortam için bağlantı başvurusunu ve ortam değişkeni bilgilerini önceden doldurabilirsiniz.

Daha fazla bilgi: Otomatik dağıtımlar için bağlantı başvurularını ve ortam değişkenlerini doldurma

Power Platform Çözümü Dışarı Aktar

Kaynak ortamdan bir çözümü verir.

YAML kod parçacığı (Dışarı aktarma)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.export-solution.PowerPlatformExportSolution@0
  displayName: 'Power Platform Export Solution '
  inputs:
    PowerPlatformEnvironment: 'My service connection'
    SolutionName: 'Contoso_sample'
    SolutionOutputFile: 'C:\Public\Contoso_sample_1_0_0_1_managed.zip'
    Managed: true
    MaxAsyncWaitTime: 120

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.export-solution.PowerPlatformExportSolution@0
  displayName: 'Power Platform Export Solution '
  inputs:
    authenticationType: PowerPlatformSPN
    PowerPlatformSPN: 'Dataverse service connection '
    SolutionName: 'Contoso_sample'
    SolutionOutputFile: 'C:\Public\Contoso_sample_1_0_0_1_managed.zip'
    Managed: true
    MaxAsyncWaitTime: 120
    ExportAutoNumberingSettings: true
    ExportCalendarSettings: true
    ExportCustomizationSettings: true
    ExportEmailTrackingSettings: true
    ExportGeneralSettings: true
    ExportIsvConfig: true
    ExportMarketingSettings: true
    ExportOutlookSynchronizationSettings: true
    ExportRelationshipRoles: true
    ExportSales: true

Parametreler (Dışarı aktarma)

Parametreler Açıklama
authenticationType
Kimlik doğrulaması türü		 (SPN için gereklidir) Kullanıcı adı/parola bağlantısı için PowerPlatformEnvironment veya Hizmet Sorumlusu/istemcisi gizli anahtarı bağlantısı için PowerPlatformSPN'yi belirtin.
PowerPlatformEnvironment
Power Platform ortam URL‘si		 Çözümü yükseltmek istediğiniz hizmet uç noktası (örneğin, https://powerappsbuildtools.crm.dynamics.com). Proje Ayarları'ndaki Hizmet Bağlantıları altında Power Platform bağlantı türü kullanılarak tanımlanır. Daha fazla bilgi: bkz. Power Platform Ortam Oluştur altındaki BuildTools.EnvironmentUrl
PowerPlatformSPN
Power Platform Hizmet Sorumlusu		 Çözümü yükseltmek istediğiniz hizmet uç noktası (örneğin, https://powerappsbuildtools.crm.dynamics.com). Proje Ayarları'ndaki Hizmet Bağlantıları altında Power Platform bağlantı türü kullanılarak tanımlanır. Daha fazla bilgi: bkz. Power Platform Ortam Oluştur altındaki BuildTools.EnvironmentUrl
SolutionName
Çözüm adı		 (Gerekli) Dışarı aktarılacak çözümün adı. Her zaman çözüm Adı kullanın Görünün Ad'ı değil.
SolutionOutputFile
Çözüm çıkış dosyası		 (Gerekli) Kaynak ortama aktarılacak çözüm .zip dosyasının yolu ve dosya adı (ör. $(Build.ArtifactStagingDirectory)$(SolutionName).zip).

Not: Değişkenler, ardışık düzenin çeşitli bölümlerine anahtar bitleri almak için kullanışlı bir yol sunar. Kapsamlı bir liste için bkz. Önceden tanımlanmış değişkenleri kullanma.
AsyncOperation
Zaman uyumsuz dışarı aktarma		 Seçili (doğru) ise, dışarı aktarma işlemi zaman uyumsuz toplu iş olarak gerçekleştirilir. Zaman uyumsuz olarak seçilmesi yoklama yapar ve MaxAsyncWaitTime süresine ulaşılıncaya kadar bekler.
MaxAsyncWaitTime
Maksimum bekleme süresi		 Zaman uyumsuz işlem için dakika olarak maksimum bekleme süresi; görevler için Azure DevOps varsayılanı gibi varsayılan değer 60 dakikadır (1 sa).
Managed
Yönetilen olarak dışarı aktar		 Seçili ise (doğru), çözümü yönetilen çözüm olarak dışarı aktarın; aksi takdirde yönetilmeyen çözüm olarak dışarı aktarın.
ExportAutoNumberingSettings
Otomatik numaralandırma ayarlarını dışarı aktar		 Otomatik numaralandırma ayarlarını dışarı aktar (true|false).
ExportCalendarSettings
Takvim ayarlarını dışarı aktar		 Takvim ayarlarını dışarı aktar (true|false).
ExportCustomizationSettings
Özelleştirme ayarlarını dışarı aktar		 Özelleştirme ayarlarını dışarı aktar (true|false).
ExportEmailTrackingSettings
E-posta izleme ayarlarını dışarı aktar		 E-posta izleme ayarlarını dışarı aktar (true|false).
ExportGeneralSettings
Genel ayarları dışarı aktar		 Genel ayarları dışarı aktar (true|false).
ExportIsvConfig
ISV yapılandırmasını dışarı aktar		 ISV yapılandırması dışarı aktar (true|false).
ExportMarketingSettings
Pazarlama ayarlarını dışarı aktar		 Pazarlama ayarlarını dışarı aktar (true|false).
ExportOutlookSynchronizationSettings
Outlook eşitleme ayarlarını dışarı aktar		 Outlook eşitleme ayarlarını dışarı aktar (true|false).
ExportRelationshipRoles
İlişki rollerini dışarı aktar		 İlişki rollerini dışarı aktar (true|false).
ExportSales
Satışları dışarı aktar		 Satışları dışarı aktarır (true|false).

Power Platform Çözümü Çıkar

Sıkıştırılmış bir çözüm dosyasını alır ve birden çok XML dosyasına ve diğer dosyalara bu dosyaların bir kaynak denetim sistemi tarafından daha kolay yönetilebilmesi için bunları kaldırır.

YAML kod parçacığı (Paket açma)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.unpack-solution.PowerPlatformUnpackSolution@0
  displayName: 'Power Platform Unpack Solution '
  inputs:
    SolutionInputFile: 'C:\Public\Contoso_sample_1_0_0_1_managed.zip'
    SolutionTargetFolder: 'C:\Public'
    SolutionType: Both

Parametreler (Paket açma)

Parametreler Açıklama
SolutionInputFile
Çözüm giriş dosyası		 (Gerekli) Paketi açılacak çözüm.zip dosyasının yolu ve dosya adı.
SolutionTargetFolder
Çözüm paketten çıkarma için hedef klasör		 (Gerekli) Çözümün paketini içine almak istediğiniz yol ve hedef klasör.
SolutionType
Çözümün türü		 (Gerekli) Paketini açmak istediğiniz çözümün türü. Seçenekler şunlardır: yönetilmeyen (önerilen), yönetilen ve her ikisi.

Power Platform Çözümü Paketle

Bu görev, kaynak denetimi tarafından temsil edilen bir çözümü başka bir ortama alınabilen bir çözüm .zip dosyası olarak paketler.

YAML kod parçacığı (Paketleme)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.pack-solution.PowerPlatformPackSolution@0
  displayName: 'Power Platform Pack Solution '
  inputs:
    SolutionSourceFolder: 'C:\Public'
    SolutionOutputFile: 'Contoso_sample_1_0_0_1_managed.zip'
    SolutionType: Managed

Parametreler (Paketleme)

Parametreler Açıklama
SolutionOutputFile
Çözüm çıkış dosyası		 (Gerekli) Çözümün paketleneceği çözüm.zip dosyasının yolu ve dosya adı.
SolutionSourceFolder
Paket çözümünün kaynak klasörü		 (Gerekli) Paketin çözüm yolu ve kaynak klasörü.
SolutionType
Çözümün türü		 (Gerekli) Paketlemek istediğiniz çözümün türü. Seçenekler şunları içerir: Yönetilen (önerilir), Yönetilmeyen ve Her İkisi.

Power Platform Çözüm Silme

Hedef ortamdaki bir çözümü siler.

YAML kod parçacığı (Sil)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.delete-solution.PowerPlatformDeleteSolution@0
  displayName: 'Power Platform Delete Solution '
  inputs:
    authenticationType: PowerPlatformSPN
    PowerPlatformSPN: 'Dataverse service connection '
    SolutionName: 'Contoso_sample'

Parametreler (Sil)

Parametreler Açıklama
authenticationType
Kimlik doğrulaması türü		 (SPN için gereklidir) Kullanıcı adı/parola bağlantısı için PowerPlatformEnvironment veya Hizmet Sorumlusu/istemcisi gizli anahtarı bağlantısı için PowerPlatformSPN'yi belirtin.
PowerPlatformEnvironment
Power Platform ortam URL‘si		 Çözümü silmek istediğiniz hizmet uç noktası (örneğin, https://powerappsbuildtools.crm.dynamics.com). Proje Ayarları'ndaki Hizmet Bağlantıları altında Power Platform bağlantı türü kullanılarak tanımlanır. Daha fazla bilgi: bkz. Power Platform Ortam Oluştur altındaki BuildTools.EnvironmentUrl
PowerPlatformSPN
Power Platform Hizmet Sorumlusu		 Çözümü silmek istediğiniz hizmet uç noktası (örneğin, https://powerappsbuildtools.crm.dynamics.com). Proje Ayarları'ndaki Hizmet Bağlantıları altında Power Platform bağlantı türü kullanılarak tanımlanır. Daha fazla bilgi: bkz. Power Platform Ortam Oluştur altındaki BuildTools.EnvironmentUrl
SolutionName
Çözüm adı		 (Gerekli) Silinecek çözümün adı. Her zaman çözüm Adı kullanın Görünün Ad'ı değil.

Power Platform Özelleştirmeleri Yayımla

Tüm özelleştirmeleri bir ortamda yayımlar.

YAML kod parçacığı (Yayımla)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.publish-customizations.PowerPlatformPublishCustomizations@0
  displayName: 'Power Platform Publish Customizations '
  inputs:
    authenticationType: PowerPlatformSPN
    PowerPlatformSPN: 'Dataverse service connection '

Parametreler (Yayımla)

Parametreler Açıklama
authenticationType
Kimlik doğrulaması türü		 (SPN için gereklidir) Kullanıcı adı/parola bağlantısı için PowerPlatformEnvironment veya Hizmet Sorumlusu/istemcisi gizli anahtarı bağlantısı için PowerPlatformSPN'yi belirtin.
PowerPlatformEnvironment
Power Platform ortam URL‘si		 Özelleştirmeleri yayımlamak istediğiniz hizmet uç noktası (örneğin, https://powerappsbuildtools.crm.dynamics.com). Proje Ayarları'ndaki Hizmet Bağlantıları altında Power Platform bağlantı türü kullanılarak tanımlanır. Daha fazla bilgi: bkz. Power Platform Ortam Oluştur altındaki BuildTools.EnvironmentUrl
PowerPlatformSPN
Power Platform Hizmet Sorumlusu		 Özelleştirmeleri yayımlamak istediğiniz hizmet uç noktası (örneğin, https://powerappsbuildtools.crm.dynamics.com). Proje Ayarları'ndaki Hizmet Bağlantıları altında Power Platform bağlantı türü kullanılarak tanımlanır. Daha fazla bilgi: bkz. Power Platform Ortam Oluştur altındaki BuildTools.EnvironmentUrl

Power Platform Çözüm Sürümü Belirle

Bir çözümün sürümünü güncelleştirir.

YAML kod parçacığı (Sürüm)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.set-solution-version.PowerPlatformSetSolutionVersion@0
  displayName: 'Power Platform Set Solution Version '
  inputs:
    authenticationType: PowerPlatformSPN
    PowerPlatformSPN: 'Dataverse service connection '
    SolutionName: 'Contoso_sample'
    SolutionVersionNumber: 1.0.0.0

Parametreler (Sürüm)

Parametreler Açıklama
authenticationType
Kimlik doğrulaması türü		 (SPN için gereklidir) Kullanıcı adı/parola bağlantısı için PowerPlatformEnvironment veya Hizmet Sorumlusu/istemcisi gizli anahtarı bağlantısı için PowerPlatformSPN'yi belirtin.
PowerPlatformEnvironment
Power Platform ortam URL‘si		 Çözüm sürümünü ayarlamak istediğiniz hizmet uç noktası (örneğin, https://powerappsbuildtools.crm.dynamics.com). Proje Ayarları'ndaki Hizmet Bağlantıları altında Power Platform bağlantı türü kullanılarak tanımlanır. Daha fazla bilgi: bkz. Power Platform Ortam Oluştur altındaki BuildTools.EnvironmentUrl
PowerPlatformSPN
Power Platform Hizmet Sorumlusu		 Çözüm sürümünü ayarlamak istediğiniz hizmet uç noktası (örneğin, https://powerappsbuildtools.crm.dynamics.com). Proje Ayarları'ndaki Hizmet Bağlantıları altında Power Platform bağlantı türü kullanılarak tanımlanır. Daha fazla bilgi: bkz. Power Platform Ortam Oluştur altındaki BuildTools.EnvironmentUrl
SolutionName
Çözüm adı		 (Gerekli) Sürümünü ayarlamak istediğiniz çözümün adı. Her zaman çözüm Adı kullanın Görünün Ad'ı değil.
SolutionVersionNumber
Çözüm sürümü numarası		 Gerekiyordu Ayarlamak istediğiniz sürüm numarasını seçebilirsiniz.

Sürüm numarası ardışık düzen içinde kodlanabileceği için, BuildId gibi bir Azure DevOps ardışık düzeni değişkeni kullanılması önerilir. Bu, sürüm numarasının "Seçenekler" sekmesi altında tam biçimini tanımlamak için seçenekler sunar; örneğin:$(Yıl:yyyy)-$(Ay:AA)-$(Gün:gg)-$(rev:rr)-3

Bu tanım daha sonra, 20200824.0.0.2'nin sabit kodlanması yerine, Sürüm Numarası özelliğini $(Build.BuildId) ile ayarlayarak Çözüm Sürümünü Ayarla görevinde kullanılabilir.

Alternatif olarak PowerShell satır içi görev betiği $(Get-Date -Format yyyy.MM.dd.HHmm) çıkışı, SolutionVersion adlı boş değişkeni Write-Host ("##vso[task.setvariable variable=SolutionVersion;]$version") olarak ayarlayın, Çözüm Sürümünü $(SolutionVersion) olarak ayarlayın.

Power Platform Bağlantı Değişkenlerini Ayarlama

BuildTools.* değişkenlerini, servis bağlantısını tek bir gerçek kaynak olarak kullanmak üzere özel komut dosyası görevlerine erişimi sağlayacak şekilde ayarlar.

YAML kod parçacığı (SetConnectionVariables)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.set-connection-variables.PowerPlatformSetConnectionVariables@2
  displayName: 'Power Platform Set Connection Variables '
  inputs:
    authenticationType: PowerPlatformSPN
    PowerPlatformSPN: 'Dataverse service connection '
  timeoutInMinutes: 2
  retryCountOnTaskFailure: 5

Parametreler (SetConnectionVariables)

Parametreler Açıklama
authenticationType
Kimlik doğrulaması türü		 (SPN için gereklidir) Kullanıcı adı/parola bağlantısı için PowerPlatformEnvironment veya Hizmet Sorumlusu/istemcisi gizli anahtarı bağlantısı için PowerPlatformSPN'yi belirtin.
PowerPlatformSPN
Power Platform Hizmet Sorumlusu		 Bağlantı değişkenlerini ayarlamak istediğiniz servis uç noktası. Proje Ayarları'ndaki Hizmet Bağlantıları altında Power Platform bağlantı türü kullanılarak tanımlanır. Daha fazla bilgi: bkz. Power Platform Ortam Oluştur altındaki BuildTools.EnvironmentUrl
timeoutInMinutes
Timeout		 Bir görevin sunucu tarafından iptal edilmeden önce yürütülmesine izin verilen maksimum süreyi dakika cinsinden belirtir. Sıfır değeri sonsuz zaman aşımını gösterir.
retryCountOnTaskFailure
Görev başarısız olursa yeniden deneme sayısı		 Görev hatası durumunda bu görev için yeniden deneme sayısını belirtir. Aracısız görevler için desteklenmez.
ApplicationId
Oturum açma için Uygulama Kimliği		 (Kullanıcı adı/parola için gereklidir) Oturum açma için kullanılacak Uygulama Kimliği (Aşağıdaki ek nota bakın).
RedirectUri
Belirtilen uygulamanın Yönlendirme URI'sı		 (Kullanıcı adı/parola için gereklidir) Belirtilen uygulamanın Yönlendirme URI'sı Uygulama Kimliği belirtilirken gereklidir. (Aşağıdaki ek nota bakın).

Not

Kullanıcı adı/parola kimlik doğrulama türü kullanılırken Uygulama Kimliği ve Yönlendirme Uri'si gerekecektir. Bu kimlik doğrulama oauth belgesinde, Dataverse ile kimlik doğrulaması için neden bir uygulama kaydı oluşturmanız gerektiği açıklanır. Kullanıcı adı/parola kimlik doğrulaması kullanarak bağlandığınızda, bağlantı bir kullanıcı adına Dataverse'e bağlanan bir uygulama gibi davranır.

Power Platform Paketi Dağıt

Paketi bir ortama dağıtır. Bir paketi tek bir çözüm dosyasına karşıt olarak dağıtmak, bir ortama birden çok çözüm, veri ve kod dağıtma seçeneği sunar.

YAML kod parçacığı (Dağıt)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.deploy-package.PowerPlatformDeployPackage@0
  displayName: 'Power Platform Deploy Package '
  inputs:
    authenticationType: PowerPlatformSPN
    PowerPlatformSPN: 'Dataverse service connection '
    PackageFile: 'C:\Users\Public\package.dll'
    MaxAsyncWaitTime: 120

Parametreler (Dağıt)

Parametreler Açıklama
authenticationType
Kimlik doğrulaması türü		 (SPN için gereklidir) Kullanıcı adı/parola bağlantısı için PowerPlatformEnvironment veya Hizmet Sorumlusu/istemcisi gizli anahtarı bağlantısı için PowerPlatformSPN'yi belirtin.
PowerPlatformEnvironment
Power Platform ortam URL‘si		 Paketi dağıtmak istediğiniz hizmet uç noktası (örneğin, https://powerappsbuildtools.crm.dynamics.com). Proje Ayarları'ndaki Hizmet Bağlantıları altında Power Platform bağlantı türü kullanılarak tanımlanır. Daha fazla bilgi: bkz. Power Platform Ortam Oluştur altındaki BuildTools.EnvironmentUrl
PowerPlatformSPN
Power Platform Hizmet Sorumlusu		 Paketi dağıtmak istediğiniz hizmet uç noktası (örneğin, https://powerappsbuildtools.crm.dynamics.com). Proje Ayarları'ndaki Hizmet Bağlantıları altında Power Platform bağlantı türü kullanılarak tanımlanır. Daha fazla bilgi: bkz. Power Platform Ortam Oluştur altındaki BuildTools.EnvironmentUrl
PackageFile
Paket dosyası		 (Gerekli) Paket dosya derlemesinin (.dll) yolu ve dosya adı.
MaxAsyncWaitTime
Maksimum bekleme süresi		 Zaman uyumsuz işlem için dakika olarak maksimum bekleme süresi; görevler için Azure DevOps varsayılanı gibi varsayılan değer 60 dakikadır (1 sa).

Ortam yönetimi görevleri

Genel Ortam Yaşam Döngüsü Yönetimi (ELM) görevlerini otomatikleştirin.

Power Platform Ortam Oluştur

Yeni bir ortam oluşturur. Yeni bir ortam oluşturmak da otomatik olarak BuildTools.EnvironmentUrl oluşturur.

Önemli

Ayarlandığında, BuildTools.EnvironmentUrl ardışık düzende yer alan sonraki görevler için varsayılan hizmet bağlantısı olarak kullanılacaktır. Bu makalede açıklanan her görev, yalnızca BuildTools.EnvironmentUrl ayarlanmadığında hizmet bağlantısındaki uç noktayı kullanır.

Yeni bir ortam yalnızca, lisansınız veya kapasiteniz ek ortam oluşturulmasına izin veriyorsa sağlanabilir. Kapasiteyi görüntüleme hakkında Daha fazla bilgi edinmek için bkz. Kapasite sayfası ayrıntıları.

YAML kod parçacığı (Ortam oluştur)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.create-environment.PowerPlatformCreateEnvironment@0
  displayName: 'Power Platform Create Environment '
  inputs:
    PowerPlatformEnvironment: 'My service connection'
    DisplayName: 'First Coffee test'
    DomainName: firstcoffee

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.create-environment.PowerPlatformCreateEnvironment@0
  displayName: 'Power Platform Create Environment '
  inputs:
    authenticationType: PowerPlatformSPN
    PowerPlatformSPN: 'Dataverse service connection '
    DisplayName: 'First Coffee prod'
    EnvironmentSku: Production
    AppsTemplate: 'D365_CustomerService,D365_FieldService'
    LocationName: canada
    LanguageName: 1036
    CurrencyName: ALL
    DomainName: firstcoffee

Parametreler (Ortam oluştur)

Parametreler Açıklama
authenticationType
Kimlik doğrulaması türü		 (SPN için gereklidir) Kullanıcı adı/parola bağlantısı için PowerPlatformEnvironment veya Hizmet Sorumlusu/istemcisi gizli anahtarı bağlantısı için PowerPlatformSPN'yi belirtin.
PowerPlatformEnvironment
Power Platform ortam URL‘si		 Ortamı oluşturmak istediğiniz hizmet uç noktası (örneğin, https://powerappsbuildtools.crm.dynamics.com). Proje Ayarları'ndaki Hizmet Bağlantıları altında Power Platform bağlantı türü kullanılarak tanımlanır.
PowerPlatformSPN
Power Platform Hizmet Sorumlusu		 Ortamı oluşturmak istediğiniz hizmet uç noktası (örneğin, https://powerappsbuildtools.crm.dynamics.com). Proje Ayarları'ndaki Hizmet Bağlantıları altında Power Platform bağlantı türü kullanılarak tanımlanır.
DisplayName
Görünen ad		 (Gerekli) Oluşturulan ortamın görünen adı.
LocationName
Dağıtım bölgesi		 (Gerekli) Ortamın oluşturulması gereken bölge.
EnvironmentSku
Ortam türü		 (Gerekli) Dağıtılacak kurulumun türü. Seçenekler şunlardır: Korumalı alan, Üretim, Deneme ve SubscriptionBasedTrial.
AppsTemplate
Uygulamalar		 Deneme ortamı dışındaki bir ortam türü için desteklenen uygulamalar şunlardır: D365_CustomerService, D365_FieldService, D365_ProjectServiceAutomation ve D365_Sales.
CurrencyName
Para Birimi		 (Gerekli) Oluşturulan ortam için baz para birimi. Para birimi, ortam oluşturulduktan sonra güncelleştirilemez.
LanguageName
Language		 (Gerekli) Ortamdaki temel dil.
DomainName
Etki Alanı Adı		 (Gerekli) Bu, URL'nin bir kısmını oluşturan ortama özel dizedir. Örneğin aşağıdaki URL'ye sahip bir ortam için: https://powerappsbuildtasks.crm.dynamics.com/, etki alanı adı "powerappsbuildtasks" olur.

Not: Zaten kullanımda olan bir etki alanı adı girerseniz, görev, 0 ile başlayarak etki alanı adına sayısal bir değer ekler. Yukarıdaki örnek için URL https://powerappsbuildtasks0.crm.dynamics.com/ olabilir.

Power Platform Ortamı Sil

Ortamı siler.

YAML kod parçacığı (Ortamı sil)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.delete-environment.PowerPlatformDeleteEnvironment@0
  displayName: 'Power Platform Delete Environment '
  inputs:
    PowerPlatformEnvironment: 'My service connection'

Parametreler (Ortamı sil)

Parametreler Açıklama
authenticationType
Kimlik doğrulaması türü		 (SPN için gereklidir) Kullanıcı adı/parola bağlantısı için PowerPlatformEnvironment veya Hizmet Sorumlusu/istemcisi gizli anahtarı bağlantısı için PowerPlatformSPN'yi belirtin.
PowerPlatformEnvironment
Power Platform ortam URL‘si		 Ortamı silmek istediğiniz hizmet uç noktası (örneğin, https://powerappsbuildtools.crm.dynamics.com). Proje Ayarları'ndaki Hizmet Bağlantıları altında Power Platform bağlantı türü kullanılarak tanımlanır.
PowerPlatformSPN
Power Platform Hizmet Sorumlusu		 Ortamı silmek istediğiniz hizmet uç noktası (örneğin, https://powerappsbuildtools.crm.dynamics.com). Proje Ayarları'ndaki Hizmet Bağlantıları altında Power Platform bağlantı türü kullanılarak tanımlanır.

Power Platform Kullanıcı Ata

Belirtilen güvenlik rolüne sahip hedef ortamına kullanıcı atayın.

YAML parçacığı (AssignUser-env)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.assign-user.PowerPlatformAssignUser@2
  displayName: 'Power Platform Assign User '
  inputs:
    authenticationType: PowerPlatformSPN
    PowerPlatformSPN: Build
    User: EnvironmentUsername
    Role: 'Environment Maker'
    ApplicationUser: true

Parametreler (AssignUser-env)

Parametreler Veri Akışı Açıklaması
authenticationType
Kimlik doğrulaması türü		 (SPN için gereklidir) Kullanıcı adı/parola bağlantısı için PowerPlatformEnvironment veya Hizmet Sorumlusu/istemcisi gizli anahtarı bağlantısı için PowerPlatformSPN'yi belirtin.
PowerPlatformSPN
Power Platform Hizmet Sorumlusu		 Kullanıcı atamak istediğiniz ortam için hizmet uç noktası (örneğin https://powerappsbuildtools.crm.dynamics.com). Proje Ayarları'ndaki Hizmet Bağlantıları altında Power Platform bağlantı türü kullanılarak tanımlanır.
User
Power Platform kullanıcı adı		 Hedef ortama atanacak Microsoft Entra nesne kimliği veya kullanıcı asıl adı.
Role
Güvenlik rolü adı veya kimliği		 Kullanıcıya atanacak güvenlik rolü adı veya kimliği.
ApplicationUser
Power Platform uygulama kullanıcı adı		 Giriş kullanıcısının bir uygulama kullanıcısı olup olmadığını belirtir (doğru|yanlış).

Power Platform Sıfırlama Ortamı

Bir ortamı sıfırlar.

YAML kod parçacığı (Reset-env)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.reset-environment.PowerPlatformResetEnvironment@2
  displayName: 'Power Platform Reset Environment '
  inputs:
    authenticationType: PowerPlatformSPN
    PowerPlatformSPN: Build
    CurrencyName: ALL
    Purpose: 'Reset to PointInTime'
    AppsTemplate: 'D365_CustomerService,D365_FieldService'

Parametreler (Reset-env)

Parametreler Veri Akışı Açıklaması
authenticationType
Kimlik doğrulaması türü		 (SPN için gereklidir) Kullanıcı adı/parola bağlantısı için PowerPlatformEnvironment veya Hizmet Sorumlusu/istemcisi gizli anahtarı bağlantısı için PowerPlatformSPN'yi belirtin.
PowerPlatformEnvironment
Power Platform ortam URL‘si		 Ortamı sıfırlamak istediğiniz hizmet uç noktası (örneğin, https://powerappsbuildtools.crm.dynamics.com). Proje Ayarları'ndaki Hizmet Bağlantıları altında Power Platform bağlantı türü kullanılarak tanımlanır.
PowerPlatformSPN
Power Platform Hizmet Sorumlusu		 Ortamı sıfırlamak istediğiniz hizmet uç noktası (örneğin, https://powerappsbuildtools.crm.dynamics.com). Proje Ayarları'ndaki Hizmet Bağlantıları altında Power Platform bağlantı türü kullanılarak tanımlanır.

Power Platform Ortamı Yedekle

Ortamı yedekler.

YAML kod parçacığı (Ortamı yedekle)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.backup-environment.PowerPlatformBackupEnvironment@0
  displayName: 'Power Platform Backup Environment '
  inputs:
    PowerPlatformEnvironment: 'My service connection'
    BackupLabel: 'Full backup - $(Build.BuildNumber)'

Parametreler (Ortamı yedekle)

Parametreler Açıklama
authenticationType
Kimlik doğrulaması türü		 (SPN için gereklidir) Kullanıcı adı/parola bağlantısı için PowerPlatformEnvironment veya Hizmet Sorumlusu/istemcisi gizli anahtarı bağlantısı için PowerPlatformSPN'yi belirtin.
PowerPlatformEnvironment
Power Platform ortam URL‘si		 Ortamı yedeklemek istediğiniz hizmet uç noktası (örneğin, https://powerappsbuildtools.crm.dynamics.com). Proje Ayarları'ndaki Hizmet Bağlantıları altında Power Platform bağlantı türü kullanılarak tanımlanır.
PowerPlatformSPN
Power Platform Hizmet Sorumlusu		 Ortamı yedeklemek istediğiniz hizmet uç noktası (örneğin, https://powerappsbuildtools.crm.dynamics.com). Proje Ayarları'ndaki Hizmet Bağlantıları altında Power Platform bağlantı türü kullanılarak tanımlanır.
BackupLabel
Yedekleme etiketi		 (Gerekli) Yedeklemeye atanacak etiket.

Power Platform Ortamı Kopyala

Ortamı hedef ortama kopyalar. İki tür kopya kullanılabilir: tam ve en az. Tam kopya hem verileri hem de çözüm meta verilerini (özelleştirmeleri) içerir, en az kopya yalnızca çözüm meta verilerini içerir, gerçek verileri içermez.

YAML kod parçacığı (Ortamı kopyala)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.copy-environment.PowerPlatformCopyEnvironment@0
  displayName: 'Power Platform Copy Environment '
  inputs:
    PowerPlatformEnvironment: 'My service connection'
    TargetEnvironmentUrl: 'https://contoso-test.crm.dynamics.com'

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.copy-environment.PowerPlatformCopyEnvironment@0
  displayName: 'Power Platform Copy Environment '
  inputs:
    authenticationType: PowerPlatformSPN
    PowerPlatformSPN: 'Dataverse service connection '
    TargetEnvironmentUrl: 'https://contoso-test.crm.dynamics.com'
    CopyType: MinimalCopy
    OverrideFriendlyName: true
    FriendlyName: 'Contoso Test'
    DisableAdminMode: false

Parametreler (Ortamı kopyala)

Parametreler Açıklama
authenticationType
Kimlik doğrulaması türü		 (SPN için gereklidir) Kullanıcı adı/parola bağlantısı için PowerPlatformEnvironment veya Hizmet Sorumlusu/istemcisi gizli anahtarı bağlantısı için PowerPlatformSPN'yi belirtin.
PowerPlatformEnvironment
Power Platform ortam URL‘si		 Kopyalama yapmak istediğiniz kaynak ortamın hizmet uç noktası (ör. https://powerappsbuildtools.crm.dynamics.com). Proje Ayarları'ndaki Hizmet Bağlantıları altında Power Platform bağlantı türü kullanılarak tanımlanır.
PowerPlatformSPN
Power Platform Hizmet Sorumlusu		 Kopyalama yapmak istediğiniz kaynak ortamın hizmet uç noktası (ör. https://powerappsbuildtools.crm.dynamics.com). Proje Ayarları'ndaki Hizmet Bağlantıları altında Power Platform bağlantı türü kullanılarak tanımlanır.
TargetEnvironmentUrl
Hedef ortam URL'si		 (Gerekli) Kopyalamak istediğiniz hedef ortamın URL'si.
CopyType
Kopyalama türü		 Gerçekleştirilecek kopyalama işleminin türü: FullCopy veya MinimalCopy
OverrideFriendlyName
Kolay adı geçersiz kıl		 Hedef ortamın kolay adını başka bir adla değiştirin (true|false).
FriendlyName
Kolay ad		 Hedef ortam için kolay ad.
DisableAdminMode
Yönetici modunu devre dışı bırak		 Yönetim modunun devre dışı bırakılıp bırakılmayacağı (true|false).

Power Platform Geri Yükleme Ortamı

Bir ortamı belirli bir yedeğe geri yükler.

YAML kod parçacığı (Restore-env)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.restore-environment.PowerPlatformRestoreEnvironment@2
  displayName: 'Power Platform Restore Environment '
  inputs:
    PowerPlatformEnvironment: 'My service connection'
    authenticationType: PowerPlatformSPN
    PowerPlatformSPN: Build
    TargetEnvironmentUrl: 'https://contoso-test.crm.dynamics.com'
    RestoreLatestBackup: false
    RestoreTimeStamp: '12/01/2022 09:00'
    FriendlyName: 'Contoso Test'

Parametreler (Restore-env)

Parametreler Veri Akışı Açıklaması
authenticationType
Kimlik doğrulaması türü		 (SPN için gereklidir) Kullanıcı adı/parola bağlantısı için PowerPlatformEnvironment veya Hizmet Sorumlusu/istemcisi gizli anahtarı bağlantısı için PowerPlatformSPN'yi belirtin.
PowerPlatformEnvironment
Power Platform ortam URL‘si		 Geri yükleme yapmak istediğiniz kaynak ortamın hizmet uç noktası (ör. https://powerappsbuildtools.crm.dynamics.com). Proje Ayarları'ndaki Hizmet Bağlantıları altında Power Platform bağlantı türü kullanılarak tanımlanır.
PowerPlatformSPN
Power Platform Hizmet Sorumlusu		 Geri yükleme yapmak istediğiniz kaynak ortamın hizmet uç noktası (ör. https://powerappsbuildtools.crm.dynamics.com). Proje Ayarları'ndaki Hizmet Bağlantıları altında Power Platform bağlantı türü kullanılarak tanımlanır.
RestoreLatestBackup
Geri yüklenecek en son yedekleme		 En son yedeklemenin geri yüklenmesinin veya RestoreTimeStamp (true|false) sağlanmasının gerekip gerekmediği.
RestoreTimeStamp
Yedeğin tarihi saati		 Yedeklemenin "aa/gg/yyyy ss:dd" biçiminde tarih saati VEYA "son" dizesi.
TargetEnvironmentUrl
Hedef ortam URL'si		 (Gerekli) Geri yüklemek istediğiniz hedef ortamın URL'si.
FriendlyName
Geri yüklenen ortamın adı		 (İsteğe bağlı) Geri yüklenen ortamın adı.
DisableAdminMode
Yönetici modunu devre dışı bırak		 Yönetim modunun devre dışı bırakılıp bırakılmayacağı (true|false).

Dataverse Verilerini Dışarı Aktarma

Sağlanan şemaya sahip bir ortamdan veri dışa aktarın.

YAML parçacığı (exportdata-env)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.export-data.PowerPlatformExportData@2
  displayName: 'Power Platform Export Data '
  inputs:
    authenticationType: PowerPlatformSPN
    PowerPlatformSPN: Build
    SchemaFile: 'C:\tempschema.xml'
    DataFile: exportdata.zip
    Overwrite: true

Parametreler (exportdata-env)

Parametreler Veri Akışı Açıklaması
authenticationType
Kimlik doğrulaması türü		 (SPN için gereklidir) Kullanıcı adı/parola bağlantısı için PowerPlatformEnvironment veya Hizmet Sorumlusu/istemcisi gizli anahtarı bağlantısı için PowerPlatformSPN'yi belirtin.
PowerPlatformSPN
Power Platform Hizmet Sorumlusu		 Verileri dışa aktarmak istediğiniz ortam için hizmet uç noktası (örneğin https://powerappsbuildtools.crm.dynamics.com). Proje Ayarları'ndaki Hizmet Bağlantıları altında Power Platform bağlantı türü kullanılarak tanımlanır.
SchemaFile
Şema XML dosyası adı		 Şema XML dosyası adı. Configuration Migration aleti kullanılarak oluşturulabilir.
DataFile
Veri dosyası adı		 Verilecek verilerin dosya adı (zip dosyası).
Overwrite
İçerik üzerine yazmak		 Üzerine yazılacak Power Pages web sitesi içeriği (doğru|yanlış).

Dataverse Verilerini İçe Aktarma

Verileri bir ortama aktarma.

YAML parçacığı (importdata-env)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.import-data.PowerPlatformImportData@2
  displayName: 'Power Platform Import Data '
  inputs:
    authenticationType: PowerPlatformSPN
    PowerPlatformSPN: Build
    DataFile: 'C:\Data\Import.zip'

Parametreler (importdata-env)

Parametreler Veri Akışı Açıklaması
authenticationType
Kimlik doğrulaması türü		 (SPN için gereklidir) Kullanıcı adı/parola bağlantısı için PowerPlatformEnvironment veya Hizmet Sorumlusu/istemcisi gizli anahtarı bağlantısı için PowerPlatformSPN'yi belirtin.
PowerPlatformSPN
Power Platform Hizmet Sorumlusu		 Verileri içe aktarmak istediğiniz ortam için hizmet uç noktası (örneğin https://powerappsbuildtools.crm.dynamics.com). Proje Ayarları'ndaki Hizmet Bağlantıları altında Power Platform bağlantı türü kullanılarak tanımlanır.
DataFile
Veri dosyası adı		 Alınacak sıkıştırılmış zip) içe aktarılacak veri dosyası veya içe aktarılacak data-schema.xml ve data.xml içeren klasör.

Power Pages yönetimi görevleri

Power Pages web sitesiyle çalışmak için görevler.

Power Platform PAPortal İndirme

Power Pages web sitesi içeriğini geçerli Dataverse ortamından indirin.

YAML parçacığı (download-paportal)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.download-paportal.PowerPlatformDownloadPaportal@2
  displayName: 'Power Platform Download PAPortal '
  inputs:
    authenticationType: PowerPlatformSPN
    PowerPlatformSPN: Build
    DownloadPath: 'C:\portals'
    WebsiteId: 'f88b70cc-580b-4f1a-87c3-41debefeb902'
    Overwrite: true

Parametreler (download-paportal)

Parametreler Veri Akışı Açıklaması
authenticationType
Kimlik doğrulaması türü		 (SPN için gereklidir) Kullanıcı adı/parola bağlantısı için PowerPlatformEnvironment veya Hizmet Sorumlusu/istemcisi gizli anahtarı bağlantısı için PowerPlatformSPN'yi belirtin.
PowerPlatformSPN
Power Platform Hizmet Sorumlusu		 İçerik indirmek istediğiniz ortamın hizmet uç noktası (ör. https://powerappsbuildtools.crm.dynamics.com). Proje Ayarları'ndaki Hizmet Bağlantıları altında Power Platform bağlantı türü kullanılarak tanımlanır.
WebsiteId
Portal web sitesi Kimliği		 İndirilecek Power Pages web sitesi kimliği.
Overwrite
İçerik üzerine yazmak		 Üzerine yazılacak Power Pages web sitesi içeriği (doğru|yanlış).
ModelVersion
Site Veri Modeli		 Yüklenecek site verilerinin standart (1) veya gelişmiş veri modelini (2) kullanacağını belirtir. Varsayılan değer: '1'.

Power Platform PAPortal Yükleme

Power Pages web sitesi içeriğini geçerli Dataverse ortamına yükleyin.

YAML parçacığı (upload-paportal)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.upload-paportal.PowerPlatformUploadPaportal@2
  displayName: 'Power Platform Upload PAPortal '
  inputs:
    authenticationType: PowerPlatformSPN
    PowerPlatformSPN: Build
    UploadPath: 'C:\portals\starter-portal'

Parametreler (upload-paportal)

Parametreler Veri Akışı Açıklaması
authenticationType
Kimlik doğrulaması türü		 (SPN için gereklidir) Kullanıcı adı/parola bağlantısı için PowerPlatformEnvironment veya Hizmet Sorumlusu/istemcisi gizli anahtarı bağlantısı için PowerPlatformSPN'yi belirtin.
PowerPlatformSPN
Power Platform Hizmet Sorumlusu		 İçerik yüklemek istediğiniz ortam için hizmet uç noktası (örneğin https://powerappsbuildtools.crm.dynamics.com). Proje Ayarları'ndaki Hizmet Bağlantıları altında Power Platform bağlantı türü kullanılarak tanımlanır.
UploadPath
Yükleme içerik yolu		 Power Pages web sitesi içeriğinin yükleneceği kaynak yol.
ModelVersion
Site Veri Modeli		 Yüklenecek site verilerinin standart (1) veya gelişmiş veri modelini (2) kullanacağını belirtir. Varsayılan değer: '1'.

Power Platform görevlerin kataloğu (önizleme)

Bu görevler Power Platform uygulamasında kataloğa karşı eylemler gerçekleştirirler ve aşağıdakileri içerir.

Not

Şimdilik, Power Platform için katalog görevleri bir Önizleme sürümüdür.

Katalog öğesi yükleme

Hedef ortama bir Catalog öğesi yükleyin.

Parametreler Veri Akışı Açıklaması
authenticationType
Kimlik doğrulaması türü		 (SPN için gereklidir) Kullanıcı adı/parola bağlantısı için PowerPlatformEnvironment veya Hizmet Sorumlusu/istemcisi gizli anahtarı bağlantısı için PowerPlatformSPN'yi belirtin.
PowerPlatformSPN
Power Platform Hizmet Sorumlusu		 İçerik yüklemek istediğiniz ortam için hizmet uç noktası (örneğin https://powerappsbuildtools.crm.dynamics.com). Proje Ayarları'ndaki Hizmet Bağlantıları altında Power Platform bağlantı türü kullanılarak tanımlanır.
Environment
Hedef ortam URL'si		 (Gerekli) Bu görevin hedeflediği ortam URL'si.
CatalogItemId
Yüklenecek Katalog Öğe Kimliği		 (Gerekli) Hedef ortama yüklenecek Katalog öğesi.
TargetEnvironmentUrl
Hedef ortam URL'si		 (Gerekli) Katalog öğesi yüklemesi için hedef ortamın URL'si (örneğin, "https://YourOrg.crm.dynamics.com").
PollStatus
Anket durumunu kontrol et		 (Seçmeli) İsteğinizin durumunu denetlemek için yoklama yapın (doğru|yanlış).

Parametreler (katalog-yükleme)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools-DEV.install-catalog.PowerPlatformInstallCatalog@2
  displayName: 'Power Platform Install Catalog '
  inputs:
    authenticationType: PowerPlatformSPN
    PowerPlatformSPN: Build
    Environment: '$(BuildTools.EnvironmentUrl)'
    CatalogItemId: '00000000-0000-0000-0000-000000000001'
    TargetEnvironmentUrl: 'https://test.crm.dynamics.com/'
    PollStatus: true

Katalog onayını gönder

Catalog onay isteği gönderin.

Parametreler Veri Akışı Açıklaması
authenticationType
Kimlik doğrulaması türü		 (SPN için gereklidir) Kullanıcı adı/parola bağlantısı için PowerPlatformEnvironment veya Hizmet Sorumlusu/istemcisi gizli anahtarı bağlantısı için PowerPlatformSPN'yi belirtin.
PowerPlatformSPN
Power Platform Hizmet Sorumlusu		 İçerik yüklemek istediğiniz ortam için hizmet uç noktası (örneğin "https://powerappsbuildtools.crm.dynamics.com"). Proje Ayarları'ndaki Hizmet Bağlantıları altında Power Platform bağlantı türü kullanılarak tanımlanır.
Environment
Hedef ortam URL'si		 (Gerekli) Bu görevin hedeflediği ortam URL'si.
CatalogSubmissionFile
Katalog gönderme dosyası		 (Gerekli) Katalog gönderme dosyasının yolunu ve dosya adını belirtin.
UsePackageSolutionZipFile
Dosya türü		 Dosya türü: paket veya çözüm zip dosyası.
SolutionZipFile
Çözüm zip dosyası adı		 Çözüm zip dosyası yol ve dosya adını belirtin.
PollStatus
Anket durumunu kontrol et		 (Seçmeli) İsteğinizin durumunu denetlemek için yoklama yapın (doğru|yanlış).

Parametreler (katalog-gönderme)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools-DEV.submit-catalog.PowerPlatformSubmitCatalog@2
  displayName: 'Power Platform Submit Catalog '
  inputs:
    authenticationType: PowerPlatformSPN
    PowerPlatformSPN: Build
    Environment: '$(BuildTools.EnvironmentUrl)'
    CatalogSubmissionFile: submission.json
    UsePackageSolutionZipFile: true
    FileType: SolutionZipFile
    SolutionZipFile: solution.zip
    PollStatus: true

Katalog istek durumu

Katalog kurma/gönderme isteğinin durumunu alın.

Parametreler Veri Akışı Açıklaması
authenticationType
Kimlik doğrulaması türü		 (SPN için gereklidir) Kullanıcı adı/parola bağlantısı için PowerPlatformEnvironment veya Hizmet Sorumlusu/istemcisi gizli anahtarı bağlantısı için PowerPlatformSPN'yi belirtin.
PowerPlatformSPN
Power Platform Hizmet Sorumlusu		 İçerik yüklemek istediğiniz ortam için hizmet uç noktası (örneğin "https://powerappsbuildtools.crm.dynamics.com"). Proje Ayarları'ndaki Hizmet Bağlantıları altında Power Platform bağlantı türü kullanılarak tanımlanır.
Environment
Hedef ortam URL'si		 (Gerekli) Bu görevin hedeflediği ortam URL'si.
TrackingId
İzleme kimliğini iste		 (Gerekli) İzleme kimliğini iste.
RequestType
İstek türü		 (Gerekli) İstek türü. (Değerler: Yükle | Gönder).

Parametreler (katalog-durum)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools-DEV.catalog-status.PowerPlatforCatalogStatus@2
  displayName: 'Power Platform Catalog Status '
  inputs:
    authenticationType: PowerPlatformSPN
    PowerPlatformSPN: Build
    Environment: '$(BuildTools.EnvironmentUrl)'
    TrackingId: '00000000-0000-0000-0000-000000000002'
    RequestType: Submit

Derleme ve yayımlama hatları

Artık, yapı araçları kullanılarak neler yapılabileceğini tanımladığımız için bu araçları yapı ve bırakma ardışıklarınıza nasıl uygulayacağınıza bakalım. Kavramsal genel bakış aşağıda gösterilmiştir. Şimdi de izleyen alt bölümlerde yapı aracı görevlerini kullanarak potansiyel satış uygulamasının ayrıntılarını görelim.

Bu ardışık düzenleri oluşturmak ve Microsoft Power Platform Build Tools kullanarak ardışık düzen üzerinde çalışmak için build tools laboratuvarını tamamlayın, bunu GitHub'dan indirebilirsiniz.

Azure Pipelines hakkında daha fazla bilgi: Azure Pipelines'ı Kullanma

Derleme ardışık düzeni: Bir çözümü bir geliştirme ortamınan dışa aktarmak (DEV)

Aşağıdaki şekil geliştirme ortamından bir çözüm veren bir ardışık düzene ekleyebileceğiniz yapı aracı görevlerini gösterir.

Bir çözümü bir geliştirme ortamınan dışa aktarın (DEV).

Yapı ardışık düzeni: yönetilen çözüm oluşturma

Aşağıdaki şekil, bir yönetilen çözüm derleyen bir ardışık düzene ekleyebileceğiniz derleme aracı görevlerini gösterir.

Yönetilen bir çözüm oluşturun.

Yayın Kanalı: üretim ortamına dağıtma (PROD)

Aşağıdaki şekil, bir üretim ortamına dağıtan bir ardışık düzene ekleyebileceğiniz derleme aracı görevlerini gösterir.

Üretim ortamına (PROD) dağıtın.

Ayrıca Bkz.

Microsoft Power Platform Build Tools için yapı araçları Azure DevOps