Microsoft Power Platform Build Tools görevleri

Makale
12/03/2024

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@2
  displayName: 'Power Platform Tool Installer'

# Installs specific versions of the Power Platform Build Tools
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.tool-installer.PowerPlatformToolInstaller@2
  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@2
  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@2
  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@2
  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@2
  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ı	`UseDefaultPACheckerEndpoint` yanlış 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ı	`FileLocation` `sasUriFile` 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@2
  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@2
  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@2
  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@2
  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@2
  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@2
  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@2
  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@2
  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@2
  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@2
  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@2
  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@2
  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@2
  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@2
  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@2
  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@2
  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@2
  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@2
  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'
    SkipAuditData: true

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.
`SkipAuditData` SkipAuditData (Denetim Verileri'ni atla)	Kopyalama işlemi sırasında denetim verilerinin atlanıp atlanmayacağı. (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

Aracılığıyla paylaş