Εργασίες Microsoft Power Platform Build Tools

  • Άρθρο

Οι διαθέσιμες εργασίες δόμησης περιγράφονται στις ακόλουθες ενότητες. Στη συνέχεια, θα παρουσιάσουμε ορισμένα παραδείγματα διοχετεύσεων Azure που κάνουν χρήση αυτών των εργασιών. Για πληροφορίες σχετικά με τα εργαλεία δόμησης και τον τρόπο λήψης τους, ανατρέξτε στο θέμα Εργαλεία δόμησης Microsoft Power Platform για διοχετεύσεις Azure.

Εργασία βοηθού

Οι διαθέσιμες εργασίες βοήθειας περιγράφονται παρακάτω.

Πρόγραμμα εγκατάστασης εργαλείου Power Platform

Αυτή η εργασία απαιτείται να προστεθεί μία φορά πριν από οποιεσδήποτε άλλες εργασίες εργαλείων δόμησης του Power Platform στις διοχετεύσεις δόμησης και κυκλοφορίας. Αυτή η εργασία εγκαθιστά ένα σύνολο συγκεκριμένων εργαλείων του Power Platform που απαιτούνται από τον εκπρόσωπο για την εκτέλεση των εργασιών δόμησης Microsoft Power Platform. Αυτή η εργασία δεν απαιτεί πρόσθετη ρύθμιση παραμέτρων. Αυτή η εργασία περιέχει παραμέτρους για τις συγκεκριμένες εκδόσεις κάθε εργαλείου που εγκαθίσταται.

Για να παραμένετε ενημερωμένοι σχετικά με τις εκδόσεις του εργαλείου με την πάροδο του χρόνου, βεβαιωθείτε ότι αυτές οι παράμετροι αντιστοιχούν στις εκδόσεις των εργαλείων που απαιτούνται για τη σωστή εκτέλεση της διοχέτευσης.

Τμήμα κώδικα YAML (Πρόγραμμα εγκατάστασης)

# 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

Παράμετροι (Πρόγραμμα εγκατάστασης)

Παράμετροι Περιγραφή
DefaultVersion
Χρήση προεπιλεγμένων εκδόσεων εργαλείων		 Ορίστε σε true ώστε να χρησιμοποιείτε την προεπιλεγμένη έκδοση όλων των εργαλείων, διαφορετικά false. Απαιτείται (και false) όταν καθορίζονται οποιεσδήποτε εκδόσεις εργαλείων.
PowerAppsAdminVersion
XrmToolingPackageDeploymentVersion
MicrosoftPowerAppsCheckerVersion
CrmSdkCoreToolsVersion
Έκδοση εργαλείου		 Η συγκεκριμένη έκδοση του εργαλείου που θα χρησιμοποιηθεί.

Power Platform WhoAmI

Επαληθεύει μια σύνδεση υπηρεσίας περιβάλλοντος του Power Platform με τη σύνδεση και την υποβολή αίτησης WhoAmI. Αυτή η εργασία μπορεί να είναι χρήσιμη για την πρόωρη συμπερίληψη στη διοχέτευση, ώστε να γίνει επαλήθευση της σύνδεσης πριν την έναρξη της επεξεργασίας.

Τμήμα κώδικα YAML (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'

Παράμετροι (WhoAmI)

Παράμετροι Περιγραφή
authenticationType
Τύπος ελέγχου ταυτότητας		 (Προαιρετικό) Καθορίστε είτε το PowerPlatformEnvironment για μια σύνδεση ονόματος χρήστη/κωδικού πρόσβασης είτε το PowerPlatformSPN για μια σύνδεση κύριου υπολογιστή-πελάτη υπηρεσίας. Περισσότερες πληροφορίες: ανατρέξτε στο BuildTools.EnvironmentUrl στην ενότητα Power Platform Δημιουργία περιβάλλοντος
PowerPlatformEnvironment
Διεύθυνση URL περιβάλλοντος Power Platform		 Το τελικό σημείο υπηρεσίας για το περιβάλλον στο οποίο θέλετε συνδεθείτε. Καθορίζεται στο Συνδέσεις υπηρεσίας στις Ρυθμίσεις έργου. Περισσότερες πληροφορίες: ανατρέξτε στο BuildTools.EnvironmentUrl στην ενότητα Power Platform Δημιουργία περιβάλλοντος
PowerPlatformSPN
Power Platform Κύρια υπηρεσία		 Το τελικό σημείο υπηρεσίας για το περιβάλλον στο οποίο θέλετε συνδεθείτε. Καθορίζεται στο Συνδέσεις υπηρεσίας στις Ρυθμίσεις έργου.

Ποιοτικός έλεγχος

Ακολουθούν οι διαθέσιμες εργασίες για τον έλεγχο της ποιότητας μιας λύσης.

Power Platform Checker

Αυτή η εργασία εκτελεί έναν έλεγχο στατικής ανάλυσης στις λύσεις σας από ένα σύνολο κανόνων βέλτιστων πρακτικών για τον εντοπισμό τυχόν προβληματικών μοτίβων που μπορεί να έχετε εισαγάγει ακούσια κατά τη δημιουργία της λύσης σας.

Τμήμα κώδικα YAML (Έλεγχος)

# 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'

Παράμετροι (Έλεγχος)

Παράμετροι Περιγραφή
PowerPlatformSPN
Σύνδεση υπηρεσίας		 (Απαιτείται) Μια σύνδεση σε ένα περιβάλλον Microsoft Power Platform με άδεια χρήσης απαιτείται για να χρησιμοποιήσετε τον έλεγχο Power Platform. Οι συνδέσεις υπηρεσίας ορίζονται στις Συνδέσεις υπηρεσίας στις Ρυθμίσεις έργου χρησιμοποιώντας τον τύπο σύνδεσης Power Platform. Περισσότερες πληροφορίες: δείτε BuildTools.EnvironmentUrl κάτω από τη Δημιουργία περιβάλλοντος Power Platform

Σημείωση: Η αρχή της υπηρεσίας και οι μέθοδοι ελέγχου ταυτότητας όνομα χρήστη/κωδικός πρόσβασης είναι διαθέσιμες για την εργασία ελέγχου. Για περισσότερες πληροφορίες σχετικά με τον τρόπο ρύθμισης των παραμέτρων των αρχών υπηρεσίας που θα χρησιμοποιηθούν σε αυτήν την εργασία, ανατρέξτε στην ενότητα Ρύθμιση παραμέτρων συνδέσεων αρχών υπηρεσίας για τα περιβάλλοντα Power Platform.
UseDefaultPACheckerEndpoint
Χρήση προεπιλεγμένου τελικού σημείου Power Platform Checker		 Από προεπιλογή (true), η γεωγραφική θέση της υπηρεσίας ελέγχου θα χρησιμοποιήσει την ίδια γεωγραφία με το περιβάλλον στο οποίο συνδέεστε.
CustomPACheckerEndpoint
Προσαρμοσμένο τελικό σημείο ελέγχου PAC		 Απαιτείται όταν το UseDefaultPACheckerEndpoint είναι false. Έχετε την επιλογή να καθορίσετε μια άλλη γεωγραφική περιφέρεια, για παράδειγμα, https://japan.api.advisor.powerapps.com. Για μια λίστα διαθέσιμων γεωγραφιών, ανατρέξτε στη Χρήση του Power Platform Checker API.
FileLocation
Θέση του/των αρχείου/ων που θα αναλυθεί/ούν		 Απαιτείται όταν αναφέρεται ένα αρχείο από μια διεύθυνση URL υπογραφής κοινόχρηστης πρόσβασης (SAS) sasUriFile.

Σημείωση: Είναι σημαντικό να έχετε αναφορές σε ένα αρχείο λύσης που έχει εξαχθεί και όχι στα μη αποσυμπιεσμένα αρχεία προέλευσης στο αποθετήριό σας. Είναι δυνατή η ανάλυση τόσο διαχειριζόμενων όσο και μη διαχειριζόμενων αρχείων λύσης.
FilesToAnalyzeSasUri
Αρχεία SAS για ανάλυση		 Απαιτείται όταν το FileLocation έχει οριστεί σε sasUriFile. Εισαγάγετε τη διεύθυνση URL του SAS. Μπορείτε να προσθέσετε περισσότερα από ένα SAS URI σε μια λίστα διαχωρισμένη με κόμμα (,) ή ελληνικό ερωτηματικό (;).
FilesToAnalyze
Τοπικά αρχεία για ανάλυση		 Απαιτείται όταν τα αρχεία SAS δεν αναλύονται. Καθορίστε τη διαδρομή και το όνομα αρχείου των αρχείων zip που θα αναλυθούν. Μπορούν να χρησιμοποιηθούν χαρακτήρες μπαλαντέρ. Για παράδειγμα, πληκτρολογήστε **\*.zip για όλα τα αρχεία zip σε όλους τους υποφακέλους.
FilesToExclude
Τοπικά αρχεία προς αποκλεισμό		 Καθορίστε τα ονόματα των αρχείων που θα αποκλειστούν από την ανάλυση. Εάν είναι περισσότερα από ένα, παρέχετε μέσω λίστας διαχωρισμένης με κόμμα (,) ή ελληνικό ερωτηματικό (;). Αυτή η λίστα μπορεί να περιλαμβάνει ένα πλήρες όνομα αρχείου ή ένα όνομα με χαρακτήρες μπαλαντέρ ή χαρακτήρες μπαλαντέρ που οδηγούν στο ίχνος, όπως *jquery ή form.js
RulesToOverride
Κανόνες παράκαμψης		 Ένας πίνακας JSON που περιέχει κανόνες και επίπεδα προς παράκαμψη. Οι τιμές που έχουν γίνει δεκτές για το επίπεδο παράκαμψης είναι: Κρίσιμη, Υψηλή, Μέση, Χαμηλή, Ενημερωτική. Παράδειγμα: [{"Id":"meta-remove-dup-reg","OverrideLevel":"Medium"},{"Id":"il-avoid-specialized-update-ops","OverrideLevel":"Medium"}]
RuleSet
Σύνολο κανόνων		 (Απαιτείται) Καθορίστε το σύνολο κανόνων που θα εφαρμοστεί. Είναι διαθέσιμα τα δύο παρακάτω σύνολα κανόνων:
  • Έλεγχος λύσης: Είναι το ίδιο σύνολο κανόνων που εκτελείται από την πύλη δημιουργού του Power Apps.
  • AppSource: Πρόκειται για το σύνολο εκτεταμένων κανόνων που χρησιμοποιείται για την πιστοποίηση μιας εφαρμογής, προκειμένου να είναι δυνατή η δημοσίευσή της στο AppSource.
ErrorLevel
Επίπεδο σφάλματος		 Σε συνδυασμό με την παράμετρο ορίου σφάλματος καθορίζει τη σοβαρότητα των σφαλμάτων και των προειδοποιήσεων που επιτρέπονται. Οι υποστηριζόμενες τιμές ορίων είναι <level>IssueCount όπου level=Κρίσιμη, Υψηλή, Μέση, Χαμηλή και Ενημερωτική.
ErrorThreshold
Όριο σφάλματος		 Καθορίζει τον αριθμό των σφαλμάτων (>=0) ενός καθορισμένου επιπέδου που επιτρέπεται για τον έλεγχο να διαβιβάσει τις λύσεις που ελέγχονται.
FailOnPowerAppsCheckerAnalysisError
Αποτυχία στο σφάλμα		 Όταν είναι true, αποτυγχάνουν σε περίπτωση που η ανάλυση του Έλεγχος Power Apps επιστρέφεται ως Failed ή FinishedWithErrors.
ArtifactDestinationName
Όνομα αντικειμένου σχεδίασης DevOps		 Καθορίστε το όνομα των αντικειμένων σχεδίασης Azure για το αρχείο .sarif του ελέγχου.

Εργασίες λύσης

Αυτό το σύνολο εργασιών μπορεί να αυτοματοποιήσει ενέργειες λύσης. Οι εργασίες περιβάλλοντος που περιγράφονται αργότερα σε αυτήν την ενότητα και οι οποίες δημιουργούν, αντιγράφουν ή επαναφέρουν ένα περιβάλλον θα αντικαταστήσουν τις συνδέσεις εξυπηρέτησης με τα περιβάλλοντα που δημιουργήθηκαν πρόσφατα. Με αυτόν τον τρόπο μπορείτε να εκτελέσετε εργασίες λύσης σε περιβάλλοντα που δημιουργούνται κατ' απαίτηση.

Λύση εισαγωγής Power Platform

Εισάγει μια λύση σε ένα περιβάλλον προορισμού.

Τμήμα κώδικα YAML (Εισαγωγή)

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

Παράμετροι (Εισαγωγή)

Παράμετροι Περιγραφή
authenticationType
Τύπος ελέγχου ταυτότητας		 (Απαιτείται για SPN) Καθορίστε είτε το PowerPlatformEnvironment για μια σύνδεση ονόματος χρήστη/κωδικού πρόσβασης είτε το PowerPlatformSPN για μια σύνδεση κύριου υπολογιστή-πελάτη υπηρεσίας.
PowerPlatformEnvironment
Διεύθυνση URL περιβάλλοντος Power Platform		 Το τελικό σημείο υπηρεσίας στο οποίο θέλετε να εισαγάγετε τη λύση (π.χ. https://powerappsbuildtools.crm.dynamics.com). Ορίζεται στην ενότητα Συνδέσεις εξυπηρέτησης στις Ρυθμίσεις έργου χρησιμοποιώντας τον τύπο σύνδεσης Power Platform. Περισσότερες πληροφορίες: ανατρέξτε στο BuildTools.EnvironmentUrl στην ενότητα Power Platform Δημιουργία περιβάλλοντος
PowerPlatformSPN
Power Platform Κύρια υπηρεσία		 Το τελικό σημείο υπηρεσίας στο οποίο θέλετε να εισαγάγετε τη λύση (π.χ. https://powerappsbuildtools.crm.dynamics.com). Ορίζεται στην ενότητα Συνδέσεις εξυπηρέτησης στις Ρυθμίσεις έργου χρησιμοποιώντας τον τύπο σύνδεσης Power Platform. Περισσότερες πληροφορίες: ανατρέξτε στο BuildTools.EnvironmentUrl στην ενότητα Power Platform Δημιουργία περιβάλλοντος
SolutionInputFile
Αρχείο εισόδου λύσης		 (Απαιτείται) Η διαδρομή και το όνομα αρχείου του αρχείου solution.zip όπου θα εισαχθεί το περιβάλλον προορισμού (π.χ. $(Build.ArtifactStagingDirectory)$(SolutionName).zip).

Σημείωση: Οι μεταβλητές σάς παρέχουν έναν εύκολο τρόπο να τοποθετήσετε τα βασικά τεμάχια δεδομένων σε διάφορα τμήματα της διοχέτευσης σας. Ανατρέξτε στην ενότητα Χρήση προκαθορισμένων μεταβλητών για μια πλήρη λίστα.
HoldingSolution
Εισαγωγή ως λύση διατήρησης		 Μια εκ των προτέρων παράμετρος (true|false) που χρησιμοποιείται όταν χρειάζεται να αναβαθμιστεί μια λύση. Αυτή η παράμετρος φιλοξενεί τη λύση στο Dataverse, αλλά δεν αναβαθμίζει τη λύση μέχρι να εκτελεστεί η εργασία "Εφαρμογή αναβάθμισης λύσης".
OverwriteUnmanagedCustomizations
Αντικατάσταση μη διαχειριζόμενων προσαρμογών		 Καθορίστε εάν θα αντικαταστήσετε μη διαχειριζόμενες προσαρμογές (true|false).
SkipProductUpdateDependencies
Παράλειψη εξαρτήσεων ενημερώσεων προϊόντος		 Καθορίστε εάν πρέπει να παραλείψετε την εφαρμογή των εξαρτήσεων που σχετίζονται με ενημερώσεις προϊόντων (true|false).
ConvertToManaged
Μετατροπή σε διαχειριζόμενο		 Καθορίστε εάν θα εισάγεται ως διαχειριζόμενη λύση (true|false).
AsyncOperation
Ασύγχρονη εισαγωγή		 Εάν επιλεγεί (true), η λειτουργία εισαγωγής θα εκτελεστεί ασύγχρονα. Αυτό συνιστάται για μεγαλύτερες λύσεις, καθώς αυτή η εργασία θα λήξει αυτόματα μετά από 4 λεπτά. Εάν επιλέξετε ασύγχρονη λειτουργία, θα γίνει σφυγμομέτρηση και θα περιμένει έως ότου επιτευχθεί το MaxAsyncWaitTime (true|false).
MaxAsyncWaitTime
Μέγιστος χρόνος αναμονής		 Μέγιστος χρόνος αναμονής σε λεπτά για την ασύγχρονη λειτουργία: η προεπιλογή είναι 60 λεπτά (1 ώρα), ίδια με την προεπιλογή Azure DevOps για τις εργασίες.
PublishWorkflows
Ενεργοποίηση διεργασιών μετά την εισαγωγή		 Καθορίστε εάν οποιεσδήποτε διεργασίες (ροές εργασιών) στη λύση θα πρέπει να ενεργοποιηθούν μετά την εισαγωγή (true|false).
UseDeploymentSettingsFile
Χρήση αρχείου ρυθμίσεων ανάπτυξης		 Οι αναφορές σύνδεσης και οι τιμές μεταβλητών περιβάλλοντος μπορούν να ρυθμιστούν με χρήση αρχείου ρυθμίσεων ανάπτυξης (true|false).
DeploymentSettingsFile
Αρχείο ρυθμίσεων ανάπτυξης		 (Απαιτείται όταν UseDeploymentSettingsFile=true) Η διαδρομή και το όνομα αρχείου του αρχείου ρυθμίσεων ανάπτυξης.

Power Platform Προσθήκη στοιχείων λύσης

Προσθέτει ένα στοιχείο λύσης σε μη διαχειριζόμενη λύση.

Τμήμα κώδικα YAML (Προσθήκη)

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

Παράμετροι (Προσθήκη)

Παράμετροι Περιγραφή
ComponentId
Το αναγνωριστικό του στοιχείου λύσης		 Το όνομα ή το αναγνωριστικό σχήματος του στοιχείου που θα προστεθεί στη λύση προορισμού.
ComponentType
Διεύθυνση URL περιβάλλοντος Power Platform		 Η τιμή που αναπαριστά το στοιχείο λύσης που προσθέτετε. Δείτε την ενότητα Χρήση προκαθορισμένων τύπων στοιχείων για μια περιεκτική λίστα τιμών στοιχείων.
SolutionUniqueName
Όνομα της λύσης		 Μοναδικό όνομα της λύσης.
AddRequiredComponents
Τυχόν στοιχεία που απαιτούνται από άλλη λύση και εξαρτώνται από το στοιχείο λύσης		 (Προαιρετικό) Υποδεικνύει εάν άλλα στοιχεία λύσης που απαιτούνται από το στοιχείο λύσης που προσθέτετε θα πρέπει επίσης να προστεθούν στη μη διαχειριζόμενη λύση.
Environment
Διεύθυνση URL ή αναγνωριστικό περιβάλλοντος		 (Προαιρετικό) Διεύθυνση URL ή αναγνωριστικό του περιβάλλοντος προορισμού.

Power Platform Εφαρμογή αναβάθμισης λύσης

Αναβαθμίζει μια λύση που έχει εισαχθεί ως λύση διατήρησης.

Τμήμα κώδικα YAML (Αναβάθμιση)

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

Παράμετροι (Αναβάθμιση)

Παράμετροι Περιγραφή
authenticationType
Τύπος ελέγχου ταυτότητας		 (Απαιτείται για SPN) Καθορίστε είτε το PowerPlatformEnvironment για μια σύνδεση ονόματος χρήστη/κωδικού πρόσβασης είτε το PowerPlatformSPN για μια σύνδεση κύριου υπολογιστή-πελάτη υπηρεσίας.
PowerPlatformEnvironment
Διεύθυνση URL περιβάλλοντος Power Platform		 Το τελικό σημείο υπηρεσίας στο οποίο θέλετε να αναβαθμίσετε τη λύση (π.χ. https://powerappsbuildtools.crm.dynamics.com). Ορίζεται στην ενότητα Συνδέσεις εξυπηρέτησης στις Ρυθμίσεις έργου χρησιμοποιώντας τον τύπο σύνδεσης Power Platform. Περισσότερες πληροφορίες: ανατρέξτε στο BuildTools.EnvironmentUrl στην ενότητα Power Platform Δημιουργία περιβάλλοντος
PowerPlatformSPN
Power Platform Κύρια υπηρεσία		 Το τελικό σημείο υπηρεσίας στο οποίο θέλετε να αναβαθμίσετε τη λύση (π.χ. https://powerappsbuildtools.crm.dynamics.com). Ορίζεται στην ενότητα Συνδέσεις εξυπηρέτησης στις Ρυθμίσεις έργου χρησιμοποιώντας τον τύπο σύνδεσης Power Platform. Περισσότερες πληροφορίες: ανατρέξτε στο BuildTools.EnvironmentUrl στην ενότητα Power Platform Δημιουργία περιβάλλοντος
SolutionName
Όνομα λύσης		 (Απαιτείται) Το όνομα της λύσης για εφαρμογή της αναβάθμισης. Να χρησιμοποιείτε πάντα το Όνομα της λύσης και όχι το Εμφανιζόμενο όνομά του.
AsyncOperation
Ασύγχρονη αναβάθμιση		 Εάν επιλεγεί (true), η λειτουργία αναβάθμισης θα εκτελεστεί ως εργασία ασύγχρονης δέσμης. Εάν επιλέξετε ασύγχρονη λειτουργία, θα γίνει σφυγμομέτρηση και θα περιμένει έως ότου επιτευχθεί το MaxAsyncWaitTime.
MaxAsyncWaitTime
Μέγιστος χρόνος αναμονής		 Μέγιστος χρόνος αναμονής σε λεπτά για την ασύγχρονη λειτουργία: η προεπιλογή είναι 60 λεπτά (1 ώρα), ίδια με την προεπιλογή Azure DevOps για τις εργασίες.

Σημείωμα

Οι μεταβλητές σάς παρέχουν έναν εύκολο τρόπο να τοποθετήσετε τα βασικά τεμάχια δεδομένων σε διάφορα τμήματα της διοχέτευσης σας. Ανατρέξτε στην ενότητα Χρήση προκαθορισμένων μεταβλητών για μια πλήρη λίστα. Μπορείτε να συμπληρώσετε εκ των προτέρων πληροφορίες αναφοράς σύνδεσης και μεταβλητών περιβάλλοντος για το περιβάλλον προορισμού κατά την εισαγωγή μιας λύσης χρησιμοποιώντας ένα αρχείο ρυθμίσεων ανάπτυξης.

Περισσότερες πληροφορίες:Προσυμπληρώστε αναφορές σύνδεσης και μεταβλητές περιβάλλοντος για αυτοματοποιημένες αναπτύξεις

Λύχη εξαγωγής Power Platform

Εξάγει μια λύση από ένα περιβάλλον προέλευσης.

Τμήμα κώδικα YAML (Εξαγωγή)

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

Παράμετροι (Εξαγωγή)

Παράμετροι Περιγραφή
authenticationType
Τύπος ελέγχου ταυτότητας		 (Απαιτείται για SPN) Καθορίστε είτε το PowerPlatformEnvironment για μια σύνδεση ονόματος χρήστη/κωδικού πρόσβασης είτε το PowerPlatformSPN για μια σύνδεση κύριου υπολογιστή-πελάτη υπηρεσίας.
PowerPlatformEnvironment
Διεύθυνση URL περιβάλλοντος Power Platform		 Το τελικό σημείο υπηρεσίας στο οποίο θέλετε να αναβαθμίσετε τη λύση (π.χ. https://powerappsbuildtools.crm.dynamics.com). Ορίζεται στην ενότητα Συνδέσεις εξυπηρέτησης στις Ρυθμίσεις έργου χρησιμοποιώντας τον τύπο σύνδεσης Power Platform. Περισσότερες πληροφορίες: ανατρέξτε στο BuildTools.EnvironmentUrl στην ενότητα Power Platform Δημιουργία περιβάλλοντος
PowerPlatformSPN
Power Platform Κύρια υπηρεσία		 Το τελικό σημείο υπηρεσίας στο οποίο θέλετε να αναβαθμίσετε τη λύση (π.χ. https://powerappsbuildtools.crm.dynamics.com). Ορίζεται στην ενότητα Συνδέσεις εξυπηρέτησης στις Ρυθμίσεις έργου χρησιμοποιώντας τον τύπο σύνδεσης Power Platform. Περισσότερες πληροφορίες: ανατρέξτε στο BuildTools.EnvironmentUrl στην ενότητα Power Platform Δημιουργία περιβάλλοντος
SolutionName
Όνομα λύσης		 (Απαιτείται) Το όνομα της λύσης προς εξαγωγή. Να χρησιμοποιείτε πάντα το Όνομα της λύσης και όχι το Εμφανιζόμενο όνομά του.
SolutionOutputFile
Αρχείο εξόδου λύσης		 (Απαιτείται) Η διαδρομή και το όνομα αρχείου του αρχείου solution.zip όπου θα εξαχθεί το περιβάλλον προέλευσης (π.χ. $(Build.ArtifactStagingDirectory)$(SolutionName).zip).

Σημείωση: Οι μεταβλητές σάς παρέχουν έναν εύκολο τρόπο να τοποθετήσετε τα βασικά τεμάχια δεδομένων σε διάφορα τμήματα της διοχέτευσης σας. Ανατρέξτε στην ενότητα Χρήση προκαθορισμένων μεταβλητών για μια πλήρη λίστα.
AsyncOperation
Ασύγχρονη εξαγωγή		 Εάν επιλεγεί (true), η λειτουργία εξαγωγής θα εκτελεστεί ως εργασία ασύγχρονης δέσμης. Εάν επιλέξετε ασύγχρονη λειτουργία, θα γίνει σφυγμομέτρηση και θα περιμένει έως ότου επιτευχθεί το MaxAsyncWaitTime.
MaxAsyncWaitTime
Μέγιστος χρόνος αναμονής		 Μέγιστος χρόνος αναμονής σε λεπτά για την ασύγχρονη λειτουργία: η προεπιλογή είναι 60 λεπτά (1 ώρα), ίδια με την προεπιλογή Azure DevOps για τις εργασίες.
Managed
Εξαγωγή ως διαχειριζόμενο		 Εάν επιλέξετε (true), εξαγάγετε τη λύση ως διαχειριζόμενη λύση. Διαφορετικά κάντε εξαγωγή ως μη διαχειριζόμενη λύση.
ExportAutoNumberingSettings
Εξαγωγή ρυθμίσεων αυτόματης αρίθμησης		 Εξαγωγή ρυθμίσεων αυτόματης αρίθμησης (true|false).
ExportCalendarSettings
Εξαγωγή ρυθμίσεων ημερολογίου		 Εξαγωγή ρυθμίσεων ημερολογίου (true|false).
ExportCustomizationSettings
Εξαγωγή ρυθμίσεων προσαρμογής		 Εξαγωγή ρυθμίσεων προσαρμογής (true|false).
ExportEmailTrackingSettings
Εξαγωγή ρυθμίσεων παρακολούθησης email		 Εξαγωγή ρυθμίσεων παρακολούθησης email (true|false).
ExportGeneralSettings
Εξαγωγή γενικών ρυθμίσεων		 Εξαγωγή γενικών ρυθμίσεων (true|false).
ExportIsvConfig
Εξαγωγή διαμόρφωσης ISV		 Εξαγωγή διαμόρωσης ISV (true|false).
ExportMarketingSettings
Εξαγωγή ρυθμίσεων μάρκετινγκ		 Εξαγωγή ρυθμίσεων μάρκετινγκ (true|false).
ExportOutlookSynchronizationSettings
Εξαγωγή ρυθμίσεων συγχρονισμού του Outlook		 Εξαγωγή ρυθμίσεων συγχρονισμού του Outlook (true|false).
ExportRelationshipRoles
Εξαγωγή ρόλων σχέσης		 Εξαγωγή ρόλων σχέσης (true|false).
ExportSales
Πωλήσεις εξαγωγών		 Πωλήσεις εξαγωγών (true|false).

Λύση αποσυμπίεσης Power Platform

Χρησιμοποιεί ένα συμπιεσμένο αρχείο λύσης και το αποσυνθέτει σε πολλαπλά αρχεία XML, έτσι ώστε τα αρχεία αυτά να είναι πιο εύκολα στην ανάγνωση και τη διαχείριση από ένα σύστημα ελέγχου προέλευσης.

Τμήμα κώδικα YAML (Αποσυμπίεση πακέτου)

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

Παράμετροι (Αποσυμπίεση πακέτου)

Παράμετροι Περιγραφή
SolutionInputFile
Αρχείο εισόδου λύσης		 (Απαιτείται) Η διαδρομή και το όνομα αρχείου του αρχείου solution.zip που θα αποσυμπιεστεί.
SolutionTargetFolder
Φάκελος προορισμού για να αποσυμπιέσετε τη λύση		 (Απαιτείται) Η διαδρομή και ο φάκελος προορισμού, όπου θέλετε να αποσυμπιέσετε τη λύση.
SolutionType
Τύπος λύσης		 (Απαιτείται) Ο τύπος της λύσης που θέλετε να αποσυμπιέσετε. Οι επιλογές περιλαμβάνουν: Μη διαχειριζόμενη (συνιστάται), Διαχειριζόμενη και Και τα δύο.

Λύση πακέτου Power Platform

Συμπιέζει μια λύση που αντιπροσωπεύεται στο στοιχείο ελέγχου προέλευσης, σε ένα αρχείο solution.zip που μπορεί να εισαχθεί σε ένα άλλο περιβάλλον.

Τμήμα κώδικα YAML (Συμπίεση πακέτου)

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

Παράμετροι (Συμπίεση πακέτου)

Παράμετροι Περιγραφή
SolutionOutputFile
Αρχείο εξόδου λύσης		 (Απαιτείται) Η διαδρομή και το όνομα αρχείου του αρχείου solution.zip στο οποίο θα συμπιεστεί η λύση.
SolutionSourceFolder
Φάκελος προέλευσης της λύσης προς συμπίεση		 (Απαιτείται) Η διαδρομή και ο φάκελος προέλευσης της λύσης που θα συμπιεστεί.
SolutionType
Τύπος λύσης		 (Απαιτείται) Ο τύπος της λύσης που θέλετε να συμπιέσετε. Οι επιλογές περιλαμβάνουν τα εξής: Διαχειριζόμενη (συνιστάται), Μη διαχειριζόμενη και και τα δύο.

Power Platform Διαγραφή λύσης

Διαγράφει μια λύση στο περιβάλλον προορισμού.

Τμήμα κώδικα YAML (Διαγραφή)

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'

Παράμετροι (Διαγραφή)

Παράμετροι Περιγραφή
authenticationType
Τύπος ελέγχου ταυτότητας		 (Απαιτείται για SPN) Καθορίστε είτε το PowerPlatformEnvironment για μια σύνδεση ονόματος χρήστη/κωδικού πρόσβασης είτε το PowerPlatformSPN για μια σύνδεση κύριου υπολογιστή-πελάτη υπηρεσίας.
PowerPlatformEnvironment
Διεύθυνση URL περιβάλλοντος Power Platform		 Το τελικό σημείο υπηρεσίας στο οποίο θέλετε να διαγράψετε τη λύση (π.χ. https://powerappsbuildtools.crm.dynamics.com). Ορίζεται στην ενότητα Συνδέσεις εξυπηρέτησης στις Ρυθμίσεις έργου χρησιμοποιώντας τον τύπο σύνδεσης Power Platform. Περισσότερες πληροφορίες: ανατρέξτε στο BuildTools.EnvironmentUrl στην ενότητα Power Platform Δημιουργία περιβάλλοντος
PowerPlatformSPN
Power Platform Κύρια υπηρεσία		 Το τελικό σημείο υπηρεσίας στο οποίο θέλετε να διαγράψετε τη λύση (π.χ. https://powerappsbuildtools.crm.dynamics.com). Ορίζεται στην ενότητα Συνδέσεις εξυπηρέτησης στις Ρυθμίσεις έργου χρησιμοποιώντας τον τύπο σύνδεσης Power Platform. Περισσότερες πληροφορίες: ανατρέξτε στο BuildTools.EnvironmentUrl στην ενότητα Power Platform Δημιουργία περιβάλλοντος
SolutionName
Όνομα λύσης		 (Απαιτείται) Το όνομα της λύσης προς διαγραφή. Να χρησιμοποιείτε πάντα το Όνομα της λύσης και όχι το Εμφανιζόμενο όνομά του.

Προσαρμογές δημοσίευσης Power Platform

Δημοσιεύει όλες τις προσαρμογές σε ένα περιβάλλον.

Τμήμα κώδικα YAML (Δημοσίευση)

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

Παράμετροι (Δημοσίευση)

Παράμετροι Περιγραφή
authenticationType
Τύπος ελέγχου ταυτότητας		 (Απαιτείται για SPN) Καθορίστε είτε το PowerPlatformEnvironment για μια σύνδεση ονόματος χρήστη/κωδικού πρόσβασης είτε το PowerPlatformSPN για μια σύνδεση κύριου υπολογιστή-πελάτη υπηρεσίας.
PowerPlatformEnvironment
Διεύθυνση URL περιβάλλοντος Power Platform		 Το τελικό σημείο υπηρεσίας στο οποίο θέλετε να δημοσιεύσετε τις προσαρμογές (π.χ. https://powerappsbuildtools.crm.dynamics.com). Ορίζεται στην ενότητα Συνδέσεις εξυπηρέτησης στις Ρυθμίσεις έργου χρησιμοποιώντας τον τύπο σύνδεσης Power Platform. Περισσότερες πληροφορίες: ανατρέξτε στο BuildTools.EnvironmentUrl στην ενότητα Power Platform Δημιουργία περιβάλλοντος
PowerPlatformSPN
Power Platform Κύρια υπηρεσία		 Το τελικό σημείο υπηρεσίας στο οποίο θέλετε να δημοσιεύσετε τις προσαρμογές (π.χ. https://powerappsbuildtools.crm.dynamics.com). Ορίζεται στην ενότητα Συνδέσεις εξυπηρέτησης στις Ρυθμίσεις έργου χρησιμοποιώντας τον τύπο σύνδεσης Power Platform. Περισσότερες πληροφορίες: ανατρέξτε στο BuildTools.EnvironmentUrl στην ενότητα Power Platform Δημιουργία περιβάλλοντος

Έκδοση λύσης συνόλου Power Platform

Ενημερώνει την έκδοση μιας λύσης.

Τμήμα κώδικα YAML (Έκδοση)

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

Παράμετροι (Έκδοση)

Παράμετροι Περιγραφή
authenticationType
Τύπος ελέγχου ταυτότητας		 (Απαιτείται για SPN) Καθορίστε είτε το PowerPlatformEnvironment για μια σύνδεση ονόματος χρήστη/κωδικού πρόσβασης είτε το PowerPlatformSPN για μια σύνδεση κύριου υπολογιστή-πελάτη υπηρεσίας.
PowerPlatformEnvironment
Διεύθυνση URL περιβάλλοντος Power Platform		 Το τελικό σημείο υπηρεσίας στο οποίο θέλετε να ορίσετε την έκδοση της λύσης (π.χ. https://powerappsbuildtools.crm.dynamics.com). Ορίζεται στην ενότητα Συνδέσεις εξυπηρέτησης στις Ρυθμίσεις έργου χρησιμοποιώντας τον τύπο σύνδεσης Power Platform. Περισσότερες πληροφορίες: ανατρέξτε στο BuildTools.EnvironmentUrl στην ενότητα Power Platform Δημιουργία περιβάλλοντος
PowerPlatformSPN
Power Platform Κύρια υπηρεσία		 Το τελικό σημείο υπηρεσίας στο οποίο θέλετε να ορίσετε την έκδοση της λύσης (π.χ. https://powerappsbuildtools.crm.dynamics.com). Ορίζεται στην ενότητα Συνδέσεις εξυπηρέτησης στις Ρυθμίσεις έργου χρησιμοποιώντας τον τύπο σύνδεσης Power Platform. Περισσότερες πληροφορίες: ανατρέξτε στο BuildTools.EnvironmentUrl στην ενότητα Power Platform Δημιουργία περιβάλλοντος
SolutionName
Όνομα λύσης		 (Απαιτείται) Το όνομα της λύσης για την οποία θα γίνει καθορισμός της έκδοσης. Να χρησιμοποιείτε πάντα το Όνομα της λύσης και όχι το Εμφανιζόμενο όνομά του.
SolutionVersionNumber
Αριθμός έκδοσης λύσης		 (Απαιτείται) Αριθμός έκδοσης που θέλετε να ορίσετε.

Παρόλο που ο αριθμός έκδοσης μπορεί να είναι κωδικοποιημένος στην διοχέτευση, συνιστάται να χρησιμοποιήσετε μια μεταβλητή διοχέτευσης Azure DevOps, όπως το BuildId. Αυτό παρέχει επιλογές για να καθορίσετε το ακριβές σχήμα του αριθμού έκδοσης στην καρτέλα "Επιλογές", για παράδειγμα: $(Έτος:εεεε)-$(Μήνας:ΜΜ)-$(Ημέρα:dd)-$(rev:rr)-3

Αυτός ο ορισμός μπορεί, στη συνέχεια, να χρησιμοποιηθεί στην εργασία Ορισμός έκδοσης λύσης, ορίζοντας την ιδιότητα αριθμός έκδοσης με: $(Build.BuildId) αντί για 20200824.0.0.2 με σκληρή κωδικοποίηση.

Εναλλακτικά, μια δέσμη ενεργειών ενσωματωμένων εργασιών powershell $(Λήψη ημερομηνίας - μορφή εεεε.ΜΜ.ηη.ΩΩλλ) έχει οριστεί σε κενή μεταβλητή με όνομα SolutionVersion ως Write-Host ("##vso[task.setvariable variable=SolutionVersion;]$version"), Ορίστε την έκδοση της λύσης ως $(SolutionVersion).

Ορίστε μεταβλητές σύνδεσης Power Platform

Ορίζει τις μεταβλητές BuildTools.* για την παροχή πρόσβασης προσαρμοσμένων εργασιών δέσμης ενεργειών ώστε να χρησιμοποιεί τη σύνδεση υπηρεσίας ως μία μοναδική πηγή αλήθειας.

Τμήμα κώδικα YAML (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

Παράμετροι (SetConnectionVariables)

Παράμετροι Περιγραφή
authenticationType
Τύπος ελέγχου ταυτότητας		 (Απαιτείται για SPN) Καθορίστε είτε το PowerPlatformEnvironment για μια σύνδεση ονόματος χρήστη/κωδικού πρόσβασης είτε το PowerPlatformSPN για μια σύνδεση κύριου υπολογιστή-πελάτη υπηρεσίας.
PowerPlatformSPN
Power Platform Κύρια υπηρεσία		 Το τελικό σημείο υπηρεσίας για το οποίο θέλετε να ορίσετε μεταβλητές σύνδεσης. Ορίζεται στην ενότητα Συνδέσεις εξυπηρέτησης στις Ρυθμίσεις έργου χρησιμοποιώντας τον τύπο σύνδεσης Power Platform. Περισσότερες πληροφορίες: ανατρέξτε στο BuildTools.EnvironmentUrl στην ενότητα Power Platform Δημιουργία περιβάλλοντος
timeoutInMinutes
Timeout		 Καθορίζει τον μέγιστο χρόνο, σε λεπτά, κατά τον οποίο επιτρέπεται να εκτελείται μια εργασία προτού ακυρωθεί από το διακομιστή. Η τιμή μηδέν υποδεικνύει ένα ατέρμονο χρονικό όριο.
retryCountOnTaskFailure
Αριθμός νέων προσπαθιεών αν η εργασία αποτύχει		 Καθορίζει τον αριθμό των νέων προσπαθειών για αυτήν την εργασία που θα συμβεί σε περίπτωση αποτυχίας της εργασίας. Δεν υποστηρίζεται για εργασίες που δεν υποστηρίζονται από εκπρόσωπους.
ApplicationId
Αναγνωριστικό εφαρμογής για σύνδεση		 (Απαιτείται για όνομα χρήστη/κωδικό πρόσβασης) Αναγνωριστικό εφαρμογής που θα χρησιμοποιηθεί για σύνδεση (Δείτε παρακάτω τη πρόσθετη σημείωση).
RedirectUri
URI ανακατεύθυνσης της συγκεκριμένης εφαρμογής		 (Απαιτείται για όνομα χρήστη/κωδικό πρόσβασης) URI ανακατεύθυνσης της καθορισμένης εφαρμογής. Απαιτείται κατά τον καθορισμό ενός αναγνωριστικού εφαρμογής. (Δείτε παρακάτω μια πρόσθετη σημείωση).

Σημείωμα

Όταν χρησιμοποιείτε τον τύπο ελέγχου ταυτότητας ονόματος χρήστη/κωδικού πρόσβασης, θα απαιτείται το αναγνωριστικό εφαρμογής και η διεύθυνση URI ανακατεύθυνσης. Αυτό το έγγραφο oauth ελέγχου ταυτότητας έχει μια εξήγηση των λόγων για τους οποίους πρέπει να δημιουργήσετε μια εγγραφή εφαρμογής για επαλήθευση της ταυτότητάς σας Dataverse. Όταν συνδέεστε χρησιμοποιώντας τον έλεγχο ταυτότητας ονόματος χρήστη/κωδικού πρόσβασης, η σύνδεση συμπεριφέρεται ως εφαρμογή η οποία συνδέεται για λογαριασμό ενός χρήστη στο Dataverse.

Πακέτο ανάπτυξης Power Platform

Αναπτύσσει ένα πακέτο σε ένα περιβάλλον. Η ανάπτυξη ενός πακέτου σε αντίθεση με ένα μόνο αρχείο λύσης σάς δίνει τη δυνατότητα να αναπτύξετε πολλές λύσεις, δεδομένα και κώδικα σε ένα περιβάλλον.

Τμήμα κώδικα YAML (Ανάπτυξη)

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

Παράμετροι (Ανάπτυξη)

Παράμετροι Περιγραφή
authenticationType
Τύπος ελέγχου ταυτότητας		 (Απαιτείται για SPN) Καθορίστε είτε το PowerPlatformEnvironment για μια σύνδεση ονόματος χρήστη/κωδικού πρόσβασης είτε το PowerPlatformSPN για μια σύνδεση κύριου υπολογιστή-πελάτη υπηρεσίας.
PowerPlatformEnvironment
Διεύθυνση URL περιβάλλοντος Power Platform		 Το τελικό σημείο υπηρεσίας στο οποίο θέλετε να αναπτύξετε το πακέτο (π.χ. https://powerappsbuildtools.crm.dynamics.com). Ορίζεται στην ενότητα Συνδέσεις εξυπηρέτησης στις Ρυθμίσεις έργου χρησιμοποιώντας τον τύπο σύνδεσης Power Platform. Περισσότερες πληροφορίες: ανατρέξτε στο BuildTools.EnvironmentUrl στην ενότητα Power Platform Δημιουργία περιβάλλοντος
PowerPlatformSPN
Power Platform Κύρια υπηρεσία		 Το τελικό σημείο υπηρεσίας στο οποίο θέλετε να αναπτύξετε το πακέτο (π.χ. https://powerappsbuildtools.crm.dynamics.com). Ορίζεται στην ενότητα Συνδέσεις εξυπηρέτησης στις Ρυθμίσεις έργου χρησιμοποιώντας τον τύπο σύνδεσης Power Platform. Περισσότερες πληροφορίες: ανατρέξτε στο BuildTools.EnvironmentUrl στην ενότητα Power Platform Δημιουργία περιβάλλοντος
PackageFile
Αρχείο πακέτου		 (Απαιτείται) Η διαδρομή και το όνομα αρχείου για τη συγκρότηση του αρχείου πακέτου (.dll).
MaxAsyncWaitTime
Μέγιστος χρόνος αναμονής		 Μέγιστος χρόνος αναμονής σε λεπτά για την ασύγχρονη λειτουργία: η προεπιλογή είναι 60 λεπτά (1 ώρα), ίδια με την προεπιλογή Azure DevOps για τις εργασίες.

Εργασίες διαχείρισης περιβάλλοντος

Αυτοματοποιήστε τις συνηθισμένες εργασίες διαχείρισης περιβάλλοντος κύκλου ζωής (ELM).

Περιβάλλον δημιουργίας Power Platform

Δημιουργεί νέο περιβάλλον. Η δημιουργία ενός νέου περιβάλλοντος δημιουργεί επίσης αυτόματα το BuildTools.EnvironmentUrl.

Σημαντικό

Όταν οριστεί, το BuildTools.EnvironmentUrl θα χρησιμοποιηθεί ως η προεπιλεγμένη σύνδεση εξυπηρέτησης για τις επόμενες εργασίες στη διοχέτευση. Κάθε εργασία που περιγράφεται σε αυτό το άρθρο χρησιμοποιεί μόνο το τελικό σημείο από τη σύνδεση εξυπηρέτησης όταν δεν έχει οριστεί το BuildTools.EnvironmentUrl.

Ένα νέο περιβάλλον μπορεί να δοθεί μόνο εάν η άδεια χρήσης ή η παραγωγική ικανότητά σας επιτρέπει τη δημιουργία επιπλέον περιβαλλόντων. Για περισσότερες πληροφορίες σχετικά με τον τρόπο προβολής της χωρητικότητας, ανατρέξτε στην ενότητα Λεπτομέρειες σελίδας χωρητικότητας.

Τμήμα κώδικα YAML (Δημιουργία περιβάλλοντος)

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

Παράμετροι (Δημιουργία περιβάλλοντος)

Παράμετροι Περιγραφή
authenticationType
Τύπος ελέγχου ταυτότητας		 (Απαιτείται για SPN) Καθορίστε είτε το PowerPlatformEnvironment για μια σύνδεση ονόματος χρήστη/κωδικού πρόσβασης είτε το PowerPlatformSPN για μια σύνδεση κύριου υπολογιστή-πελάτη υπηρεσίας.
PowerPlatformEnvironment
Διεύθυνση URL περιβάλλοντος Power Platform		 Το τελικό σημείο υπηρεσίας στο οποίο θέλετε να δημιουργήσετε το περιβάλλον (π.χ. https://powerappsbuildtools.crm.dynamics.com). Ορίζεται στην ενότητα Συνδέσεις εξυπηρέτησης στις Ρυθμίσεις έργου χρησιμοποιώντας τον τύπο σύνδεσης Power Platform.
PowerPlatformSPN
Power Platform Κύρια υπηρεσία		 Το τελικό σημείο υπηρεσίας στο οποίο θέλετε να δημιουργήσετε το περιβάλλον (π.χ. https://powerappsbuildtools.crm.dynamics.com). Ορίζεται στην ενότητα Συνδέσεις εξυπηρέτησης στις Ρυθμίσεις έργου χρησιμοποιώντας τον τύπο σύνδεσης Power Platform.
DisplayName
Εμφανιζόμενο όνομα		 (Απαιτείται) Το εμφανιζόμενο όνομα του περιβάλλοντος που δημιουργήθηκε.
LocationName
Περιοχή ανάπτυξης		 (Απαιτείται) Η περιοχή στην οποία πρέπει να δημιουργηθεί το περιβάλλον.
EnvironmentSku
Τύπος περιβάλλοντος		 (Απαιτείται) Ο τύπος της παρουσίας που θα αναπτυχθεί. Οι επιλογές είναι Φίλτρο, Παραγωγή, Δοκιμαστική έκδοση και SubscriptionBasedTrial.
AppsTemplate
Εφαρμογές		 Για έναν τύπο μη δοκιμαστικού περιβάλλοντος, οι υποστηριζόμενες εφαρμογές είναι D365_CustomerService, D365_FieldService, D365_ProjectServiceAutomation και D365_Sales.
CurrencyName
Νομισματική μονάδα		 (Απαιτείται) Βασική νομισματική μονάδα για το περιβάλλον που δημιουργήθηκε. Δεν είναι δυνατή η ενημέρωση του νομίσματος μετά τη δημιουργία του περιβάλλοντος.
LanguageName
Language		 (Απαιτείται) Η βασική γλώσσα στο περιβάλλον.
DomainName
Όνομα τομέα		 (Απαιτείται) Πρόκειται για τη συμβολοσειρά που αφορά το συγκεκριμένο περιβάλλον και η οποία αποτελεί μέρος της διεύθυνσης URL. Για παράδειγμα, για ένα περιβάλλον με την ακόλουθη διεύθυνση URL: https://powerappsbuildtasks.crm.dynamics.com/, το όνομα τομέα θα ήταν 'powerappsbuildtasks'.

Σημείωση: Εάν εισάγετε ένα όνομα τομέα που χρησιμοποιείται ήδη, η εργασία προσαρτά μια αριθμητική τιμή στο όνομα τομέα, ξεκινώντας από το 0. Για το παραπάνω παράδειγμα, η διεύθυνση URL θα γινόταν https://powerappsbuildtasks0.crm.dynamics.com/.

Περιβάλλον διαγραφής Power Platform

Διαγράφει ένα περιβάλλον.

Τμήμα κώδικα YAML (Διαγραφή περιβάλλοντος)

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

Παράμετροι (Διαγραφή περιβάλλοντος)

Παράμετροι Περιγραφή
authenticationType
Τύπος ελέγχου ταυτότητας		 (Απαιτείται για SPN) Καθορίστε είτε το PowerPlatformEnvironment για μια σύνδεση ονόματος χρήστη/κωδικού πρόσβασης είτε το PowerPlatformSPN για μια σύνδεση κύριου υπολογιστή-πελάτη υπηρεσίας.
PowerPlatformEnvironment
Διεύθυνση URL περιβάλλοντος Power Platform		 Το τελικό σημείο υπηρεσίας στο οποίο θέλετε να διαγραφεί το περιβάλλον (π.χ. https://powerappsbuildtools.crm.dynamics.com). Ορίζεται στην ενότητα Συνδέσεις εξυπηρέτησης στις Ρυθμίσεις έργου χρησιμοποιώντας τον τύπο σύνδεσης Power Platform.
PowerPlatformSPN
Power Platform Κύρια υπηρεσία		 Το τελικό σημείο υπηρεσίας στο οποίο θέλετε να διαγραφεί το περιβάλλον (π.χ. https://powerappsbuildtools.crm.dynamics.com). Ορίζεται στην ενότητα Συνδέσεις εξυπηρέτησης στις Ρυθμίσεις έργου χρησιμοποιώντας τον τύπο σύνδεσης Power Platform.

Ανάθεση χρήστη Power Platform

Ανάθεση χρήστη σε περιβάλλον προορισμού με καθορισμένο ρόλο ασφαλείας.

Τμήμα κώδικα YAML (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

Παράμετροι (AssignUser-env)

Παράμετροι Περιγραφή
authenticationType
Τύπος ελέγχου ταυτότητας		 (Απαιτείται για SPN) Καθορίστε είτε το PowerPlatformEnvironment για μια σύνδεση ονόματος χρήστη/κωδικού πρόσβασης είτε το PowerPlatformSPN για μια σύνδεση κύριου υπολογιστή-πελάτη υπηρεσίας.
PowerPlatformSPN
Power Platform Κύρια υπηρεσία		 Το τελικό σημείο υπηρεσίας για το περιβάλλον στον οποίο θέλετε να αναθέσετε τον χρήση (π.χ. https://powerappsbuildtools.crm.dynamics.com). Ορίζεται στην ενότητα Συνδέσεις εξυπηρέτησης στις Ρυθμίσεις έργου χρησιμοποιώντας τον τύπο σύνδεσης Power Platform.
User
Όνομα χρήστη Power Platform		 Αναγνωριστικό αντικειμένου ή το κύριο όνομα χρήστη Microsoft Entra για εκχώρηση στο περιβάλλον προορισμού.
Role
Όνομα ή αναγνωριστικό ρόλου ασφαλείας		 Το όνομα ή αναγνωριστικό του ρόλου ασφαλείας προς εκχώρηση στον χρήστη.
ApplicationUser
Όνομα χρήστη εφαρμογής Power Platform		 Καθορίζει αν ο χρήστης εισαγωγής είναι χρήστης εφαρμογής (true|false).

Επαναφορά περιβάλλοντος Power Platform

Επαναφέρει ένα περιβάλλον.

Τμήμα κώδικα YAML (Επαναφορά περιβάλλοντος)

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'

Παράμετροι (Επαναφορά περιβάλλοντος)

Παράμετροι Περιγραφή
authenticationType
Τύπος ελέγχου ταυτότητας		 (Απαιτείται για SPN) Καθορίστε είτε το PowerPlatformEnvironment για μια σύνδεση ονόματος χρήστη/κωδικού πρόσβασης είτε το PowerPlatformSPN για μια σύνδεση κύριου υπολογιστή-πελάτη υπηρεσίας.
PowerPlatformEnvironment
Διεύθυνση URL περιβάλλοντος Power Platform		 Το τελικό σημείο υπηρεσίας στο οποίο θέλετε να επαναφέρετε το περιβάλλον (π.χ. https://powerappsbuildtools.crm.dynamics.com). Ορίζεται στην ενότητα Συνδέσεις εξυπηρέτησης στις Ρυθμίσεις έργου χρησιμοποιώντας τον τύπο σύνδεσης Power Platform.
PowerPlatformSPN
Power Platform Κύρια υπηρεσία		 Το τελικό σημείο υπηρεσίας στο οποίο θέλετε να επαναφέρετε το περιβάλλον (π.χ. https://powerappsbuildtools.crm.dynamics.com). Ορίζεται στην ενότητα Συνδέσεις εξυπηρέτησης στις Ρυθμίσεις έργου χρησιμοποιώντας τον τύπο σύνδεσης Power Platform.

Περιβάλλον αντιγράφου ασφαλείας Power Platform

Δημιουργεί αντίγραφο ασφαλείας για ένα περιβάλλον.

Τμήμα κώδικα YAML (Αντίγραφο ασφαλείας περιβάλλοντος)

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)'

Παράμετροι (Αντίγραφο ασφαλείας περιβάλλοντος)

Παράμετροι Περιγραφή
authenticationType
Τύπος ελέγχου ταυτότητας		 (Απαιτείται για SPN) Καθορίστε είτε το PowerPlatformEnvironment για μια σύνδεση ονόματος χρήστη/κωδικού πρόσβασης είτε το PowerPlatformSPN για μια σύνδεση κύριου υπολογιστή-πελάτη υπηρεσίας.
PowerPlatformEnvironment
Διεύθυνση URL περιβάλλοντος Power Platform		 Το τελικό σημείο υπηρεσίας στο οποίο θέλετε να δημιουργηθεί αντίγραφο ασφαλείας περιβάλλοντος (π.χ. https://powerappsbuildtools.crm.dynamics.com). Ορίζεται στην ενότητα Συνδέσεις εξυπηρέτησης στις Ρυθμίσεις έργου χρησιμοποιώντας τον τύπο σύνδεσης Power Platform.
PowerPlatformSPN
Power Platform Κύρια υπηρεσία		 Το τελικό σημείο υπηρεσίας στο οποίο θέλετε να δημιουργηθεί αντίγραφο ασφαλείας περιβάλλοντος (π.χ. https://powerappsbuildtools.crm.dynamics.com). Ορίζεται στην ενότητα Συνδέσεις εξυπηρέτησης στις Ρυθμίσεις έργου χρησιμοποιώντας τον τύπο σύνδεσης Power Platform.
BackupLabel
Ετικέτα αντιγράφου ασφαλείας		 (Απαιτείται) Η ετικέτα που θα ανατεθεί στο αντίγραφο ασφαλείας.

Περιβάλλον αντιγρφής Power Platform

Αντιγράφει ένα περιβάλλον στο περιβάλλον στόχο. Διατίθενται δύο τύποι αντιγράφων: πλήρες και ελάχιστο. Ένα Πλήρες αντίγραφο περιλαμβάνει τόσο τα δεδομένα όσο και τα μετα-δεδομένα λύσης (προσαρμογές), ενώ ένα ελάχιστο αντίγραφο περιλαμβάνει μόνο μετα-δεδομένα λύσης και όχι τα πραγματικά δεδομένα.

Τμήμα κώδικα YAML (Αντιγραφή περιβάλλοντος)

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

Παράμετροι (Αντιγραφή περιβάλλοντος)

Παράμετροι Περιγραφή
authenticationType
Τύπος ελέγχου ταυτότητας		 (Απαιτείται για SPN) Καθορίστε είτε το PowerPlatformEnvironment για μια σύνδεση ονόματος χρήστη/κωδικού πρόσβασης είτε το PowerPlatformSPN για μια σύνδεση κύριου υπολογιστή-πελάτη υπηρεσίας.
PowerPlatformEnvironment
Διεύθυνση URL περιβάλλοντος Power Platform		 Το τελικό σημείο υπηρεσίας για το περιβάλλον προέλευσης από το οποίο θέλετε να κάνετε αντιγραφή (π.χ. https://powerappsbuildtools.crm.dynamics.com). Ορίζεται στην ενότητα Συνδέσεις εξυπηρέτησης στις Ρυθμίσεις έργου χρησιμοποιώντας τον τύπο σύνδεσης Power Platform.
PowerPlatformSPN
Power Platform Κύρια υπηρεσία		 Το τελικό σημείο υπηρεσίας για το περιβάλλον προέλευσης από το οποίο θέλετε να κάνετε αντιγραφή (π.χ. https://powerappsbuildtools.crm.dynamics.com). Ορίζεται στην ενότητα Συνδέσεις εξυπηρέτησης στις Ρυθμίσεις έργου χρησιμοποιώντας τον τύπο σύνδεσης Power Platform.
TargetEnvironmentUrl
URL περιβάλλοντος προορισμού		 (Απαιτείται) Η διεύθυνση URL για το περιβάλλον προορισμού στο οποίο θέλετε να αντιγράψετε το.
CopyType
Τύπος αντιγραφής		 Ο τύπος αντιγραφής που θα εκτελεστεί: FullCopy ή MinimalCopy
OverrideFriendlyName
Παράκαμψη φιλικού ονόματος		 Αλλάξτε το φιλικό όνομα του περιβάλλοντος προορισμού σε άλλο όνομα (true|false).
FriendlyName
Φιλικό όνομα		 Το φιλικό όνομα του περιβάλλοντος προορισμού.
DisableAdminMode
Απενεργοποίηση λειτουργίας διαχείρισης		 Μπορείτε να επιλέξετε εάν θα απενεργοποιείται η λειτουργία διαχείρισης (true|false).

Επαναφορά περιβάλλοντος Power Platform

Επαναφέρει ένα περιβάλλον σε ένα δεδομένο αντίγραφο ασφαλείας.

Τμήμα κώδικα YAML (Επαναφορά περιβάλλοντος)

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'

Παράμετροι (Επαναφορά περιβάλλοντος)

Παράμετροι Περιγραφή
authenticationType
Τύπος ελέγχου ταυτότητας		 (Απαιτείται για SPN) Καθορίστε είτε το PowerPlatformEnvironment για μια σύνδεση ονόματος χρήστη/κωδικού πρόσβασης είτε το PowerPlatformSPN για μια σύνδεση κύριου υπολογιστή-πελάτη υπηρεσίας.
PowerPlatformEnvironment
Διεύθυνση URL περιβάλλοντος Power Platform		 Το τελικό σημείο υπηρεσίας για το περιβάλλον προέλευσης από το οποίο θέλετε να κάνετε επαναφορά (π.χ. https://powerappsbuildtools.crm.dynamics.com). Ορίζεται στην ενότητα Συνδέσεις εξυπηρέτησης στις Ρυθμίσεις έργου χρησιμοποιώντας τον τύπο σύνδεσης Power Platform.
PowerPlatformSPN
Power Platform Κύρια υπηρεσία		 Το τελικό σημείο υπηρεσίας για το περιβάλλον προέλευσης από το οποίο θέλετε να κάνετε επαναφορά (π.χ. https://powerappsbuildtools.crm.dynamics.com). Ορίζεται στην ενότητα Συνδέσεις εξυπηρέτησης στις Ρυθμίσεις έργου χρησιμοποιώντας τον τύπο σύνδεσης Power Platform.
RestoreLatestBackup
Τελευταίο αντίγραφο ασφαλείας για επαναφορά		 Μπορείτε να επιλέξετε εάν θα επαναφέρετε το πιο πρόσφατο αντίγραφο ασφαλείας ή θα παρέχετε το RestoreTimeStamp (true|false).
RestoreTimeStamp
Ημερομηνία/ώρα του αντιγράφου ασφαλείας		 Ημερομηνία/ώρα του αντιγράφου ασφαλείας σε μορφή "μμ/ηη/εεεε ωω:λλ" Ή με τη συμβολοσειρά "πιο πρόσφατο".
TargetEnvironmentUrl
URL περιβάλλοντος προορισμού		 (Απαιτείται) Η διεύθυνση URL για το περιβάλλον προορισμού στο οποίο θέλετε να επαναφέρετε.
FriendlyName
Όνομα του περιβάλλοντος που επαναφέρθηκε		 (Προαιρετικό) Όνομα του περιβάλλοντος που επαναφέρθηκε.
DisableAdminMode
Απενεργοποίηση λειτουργίας διαχείρισης		 Μπορείτε να επιλέξετε εάν θα απενεργοποιείται η λειτουργία διαχείρισης (true|false).

Εξαγωγή δεδομένων Dataverse

Εξαγωγή δεδομένων από περιβάλλον με το παρεχόμενο σχήμα.

Τμήμα κώδικα YAML (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

Παράμετροι (exportdata-env)

Παράμετροι Περιγραφή
authenticationType
Τύπος ελέγχου ταυτότητας		 (Απαιτείται για SPN) Καθορίστε είτε το PowerPlatformEnvironment για μια σύνδεση ονόματος χρήστη/κωδικού πρόσβασης είτε το PowerPlatformSPN για μια σύνδεση κύριου υπολογιστή-πελάτη υπηρεσίας.
PowerPlatformSPN
Power Platform Κύρια υπηρεσία		 Το τελικό σημείο υπηρεσίας για το περιβάλλον από το οποίο θέλετε να εξαγάγετε δεδομένα (π.χ. https://powerappsbuildtools.crm.dynamics.com). Ορίζεται στην ενότητα Συνδέσεις εξυπηρέτησης στις Ρυθμίσεις έργου χρησιμοποιώντας τον τύπο σύνδεσης Power Platform.
SchemaFile
Όνομα αρχείου XML σχήματος		 Όνομα αρχείου XML σχήματος. Μπορεί να δημιουργηθεί με χρήση του εργαλείου Configuration Migration.
DataFile
Όνομα αρχείου δεδομένων		 Όνομα αρχείου για τα δεδομένα προς εξαγωγή (αρχείο zip).
Overwrite
Αντικατάσταση περιεχομένου		 Περιεχόμενο τοποθεσίας Web Power Pages για αντικατάσταση (true|false).

Εισαγωγή δεδομένων Dataverse

Εισαγωγή δεδομένων σε περιβάλλον.

Τμήμα κώδικα YAML (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'

Παράμετροι (importdata-env)

Παράμετροι Περιγραφή
authenticationType
Τύπος ελέγχου ταυτότητας		 (Απαιτείται για SPN) Καθορίστε είτε το PowerPlatformEnvironment για μια σύνδεση ονόματος χρήστη/κωδικού πρόσβασης είτε το PowerPlatformSPN για μια σύνδεση κύριου υπολογιστή-πελάτη υπηρεσίας.
PowerPlatformSPN
Power Platform Κύρια υπηρεσία		 Το τελικό σημείο υπηρεσίας για το περιβάλλον από το οποίο θέλετε να κάνετε εισαγωγή δεδομένων (π.χ. https://powerappsbuildtools.crm.dynamics.com). Ορίζεται στην ενότητα Συνδέσεις εξυπηρέτησης στις Ρυθμίσεις έργου χρησιμοποιώντας τον τύπο σύνδεσης Power Platform.
DataFile
Όνομα αρχείου δεδομένων		 Όνομα αρχείου για εισαγωγή του αρχείου συμπιεσμένων δεδομένων zip ή ο φάκελος με αρχείο data-schema.xml και data.xml προς εισαγωγή.

Εργασίες διαχείρισης Power Pages

Εργασίες για εργασία με την τοποθεσία web του Power Pages.

Λήψη του PAPortal Power Platform

Λήψη περιεχομένου τοποθεσίας web Power Pages από το τρέχον περιβάλλον Dataverse.

Τμήμα κώδικα YAML (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

Παράμετροι (download-paportal)

Παράμετροι Περιγραφή
authenticationType
Τύπος ελέγχου ταυτότητας		 (Απαιτείται για SPN) Καθορίστε είτε το PowerPlatformEnvironment για μια σύνδεση ονόματος χρήστη/κωδικού πρόσβασης είτε το PowerPlatformSPN για μια σύνδεση κύριου υπολογιστή-πελάτη υπηρεσίας.
PowerPlatformSPN
Power Platform Κύρια υπηρεσία		 Το τελικό σημείο υπηρεσίας για το περιβάλλον από το οποίο θέλετε να κατεβάσετε περιεχόμενο (π.χ. https://powerappsbuildtools.crm.dynamics.com). Ορίζεται στην ενότητα Συνδέσεις εξυπηρέτησης στις Ρυθμίσεις έργου χρησιμοποιώντας τον τύπο σύνδεσης Power Platform.
WebsiteId
Αναγνωριστικό τοποθεσίας Web πύλης		 Αναγνωριστικό τοποθεσίας web Power Pages για λήψη.
Overwrite
Αντικατάσταση περιεχομένου		 Περιεχόμενο τοποθεσίας Web Power Pages για αντικατάσταση (true|false).

Λήψη PAPortal Power Platform

Αποστολή περιεχομένου τοποθεσίας Web Power Pages στο τρέχον περιβάλλον Dataverse.

Τμήμα κώδικα YAML (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'

Παράμετροι (upload-paportal)

Παράμετροι Περιγραφή
authenticationType
Τύπος ελέγχου ταυτότητας		 (Απαιτείται για SPN) Καθορίστε είτε το PowerPlatformEnvironment για μια σύνδεση ονόματος χρήστη/κωδικού πρόσβασης είτε το PowerPlatformSPN για μια σύνδεση κύριου υπολογιστή-πελάτη υπηρεσίας.
PowerPlatformSPN
Power Platform Κύρια υπηρεσία		 Το τελικό σημείο υπηρεσίας για το περιβάλλον στο οποίο θέλετε να στείλετε περιεχόμενο (π.χ. https://powerappsbuildtools.crm.dynamics.com). Ορίζεται στην ενότητα Συνδέσεις εξυπηρέτησης στις Ρυθμίσεις έργου χρησιμοποιώντας τον τύπο σύνδεσης Power Platform.
UploadPath
Διαδρομή αποστολής περιεχομένου		 Διαδρομή από όπου θα γίνει αποστολή του περιεχομένου της τοποθεσίας Web Power Pages.

Εργασίες καταλόγου για Power Platform (έκδοση προεπισκόπησης)

Αυτές οι εργασίες εκτελούν ενέργειες κατά του καταλόγου στο Power Platform και περιλαμβάνουν τα εξής.

Σημείωμα

Προς το παρόν, οι εργασίες καταλόγου για το Power Platform είναι μια έκδοση προεπισκόπησης .

Εγκατάσταση στοιχείου καταλόγου

Εγκαταστήστε ένα στοιχείο Catalog στο περιβάλλον προορισμού.

Παράμετροι Περιγραφή
authenticationType
Τύπος ελέγχου ταυτότητας		 (Απαιτείται για SPN) Καθορίστε είτε το PowerPlatformEnvironment για μια σύνδεση ονόματος χρήστη/κωδικού πρόσβασης είτε το PowerPlatformSPN για μια σύνδεση κύριου υπολογιστή-πελάτη υπηρεσίας.
PowerPlatformSPN
Power Platform Κύρια υπηρεσία		 Το τελικό σημείο υπηρεσίας για το περιβάλλον στο οποίο θέλετε να στείλετε περιεχόμενο (π.χ. https://powerappsbuildtools.crm.dynamics.com). Ορίζεται στην ενότητα Συνδέσεις εξυπηρέτησης στις Ρυθμίσεις έργου χρησιμοποιώντας τον τύπο σύνδεσης Power Platform.
Environment
URL περιβάλλοντος προορισμού		 (Απαιτείται) Διεύθυνση URL περιβάλλοντος για αυτήν την εργασία.
CatalogItemId
Αναγνωριστικό στοιχείου καταλόγου προς εγκατάσταση		 (Απαιτείται) Στοιχείο καταλόγου που θα εγκατασταθεί στο περιβάλλον προορισμού.
TargetEnvironmentUrl
URL περιβάλλοντος προορισμού		 (Υποχρεωτικό) Η διεύθυνση URL του περιβάλλοντος προορισμού για την εγκατάσταση στοιχείου καταλόγου (για παράδειγμα, "https://YourOrg.crm.dynamics.com").
PollStatus
Έλεγχος κατάστασης σφυγμομέτρησης		 (Προαιρετικό) Σφυγμομέτρηση για έλεγχο της κατάστασης του αιτήματός σας (true|false).

Παράμετροι (catalog-install)

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

Υποβολή έγκρισης καταλόγου

Υποβολή αίτησης έγκρισης Catalog.

Παράμετροι Περιγραφή
authenticationType
Τύπος ελέγχου ταυτότητας		 (Απαιτείται για SPN) Καθορίστε είτε το PowerPlatformEnvironment για μια σύνδεση ονόματος χρήστη/κωδικού πρόσβασης είτε το PowerPlatformSPN για μια σύνδεση κύριου υπολογιστή-πελάτη υπηρεσίας.
PowerPlatformSPN
Power Platform Κύρια υπηρεσία		 Το τελικό σημείο υπηρεσίας για το περιβάλλον στο οποίο θέλετε να στείλετε περιεχόμενο (π.χ. "https://powerappsbuildtools.crm.dynamics.com"). Ορίζεται στην ενότητα Συνδέσεις εξυπηρέτησης στις Ρυθμίσεις έργου χρησιμοποιώντας τον τύπο σύνδεσης Power Platform.
Environment
URL περιβάλλοντος προορισμού		 (Απαιτείται) Διεύθυνση URL περιβάλλοντος για αυτήν την εργασία.
CatalogSubmissionFile
Αρχείο υποβολής καταλόγου		 (Απαιτείται) Καθορίστε τη διαδρομή και το όνομα αρχείου του αρχείου υποβολής καταλόγου.
UsePackageSolutionZipFile
Τύπος αρχείου		 Τύπος αρχείου: αρχείο zip πακέτου ή λύσης.
SolutionZipFile
Όνομα αρχείου zip λύσης		 Προσδιορίστε τη διαδρομή και το όνομα αρχείου του αρχείου solution.zip.
PollStatus
Έλεγχος κατάστασης σφυγμομέτρησης		 (Προαιρετικό) Σφυγμομέτρηση για έλεγχο της κατάστασης του αιτήματός σας (true|false).

Παράμετροι (catalog-submit)

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

Κατάσταση αίτησης καταλόγου

Λάβετε την κατάσταση του αιτήματος εγκατάστασης/υποβολής καταλόγου.

Παράμετροι Περιγραφή
authenticationType
Τύπος ελέγχου ταυτότητας		 (Απαιτείται για SPN) Καθορίστε είτε το PowerPlatformEnvironment για μια σύνδεση ονόματος χρήστη/κωδικού πρόσβασης είτε το PowerPlatformSPN για μια σύνδεση κύριου υπολογιστή-πελάτη υπηρεσίας.
PowerPlatformSPN
Power Platform Κύρια υπηρεσία		 Το τελικό σημείο υπηρεσίας για το περιβάλλον στο οποίο θέλετε να στείλετε περιεχόμενο (π.χ. "https://powerappsbuildtools.crm.dynamics.com"). Ορίζεται στην ενότητα Συνδέσεις εξυπηρέτησης στις Ρυθμίσεις έργου χρησιμοποιώντας τον τύπο σύνδεσης Power Platform.
Environment
URL περιβάλλοντος προορισμού		 (Απαιτείται) Διεύθυνση URL περιβάλλοντος για αυτήν την εργασία.
TrackingId
Αναγνωριστικό παρακολούθησης αίτησης		 (Απαιτείται) Αίτημα αναγνωριστικού παρακολούθησης.
RequestType
Τύπος αίτησης		 (Υποχρεωτικό) Τύπος αιτήματος. (Τιμές: Εγκατάσταση | Υποβολή).

Παράμετροι (catalog-status)

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

Διοχετεύσεις δόμησης και κυκλοφορίας

Τώρα που εντοπίσαμε τι μπορεί να γίνει με τη χρήση των εργαλείων δόμησης, ας δούμε πώς μπορείτε να εφαρμόσετε αυτά τα εργαλεία στις διοχετεύσεις δόμησης και απελευθέρωσης. Παρακάτω εμφανίζεται μια εννοιολογική επισκόπηση. Ας δούμε τώρα μερικές λεπτομέρειες σχετικά με την υλοποίηση της διοχέτευσης χρησιμοποιώντας τις εργασίες του εργαλείου δόμησης, στις υπο-ενότητες που ακολουθούν.

Για να μάθετε περισσότερα σχετικά με τη δημιουργία αυτών των αγωγών και για να κάνετε πρακτική συγγραφή διοχέτευσης με χρήση των Microsoft Power Platform Build Tools, ολοκληρώστε τα εργαστήρια εργαλείων δόμησης, τα οποία μπορείτε να λάβετε από το GitHub.

Περισσότερες πληροφορίες σχετικά με τις διοχετεύσεις Azure: Χρησιμοποιήστε διοχετεύσεις Azure

Διοχέτευση δόμησης: Εξαγωγή λύσης από ένα περιβάλλον ανάπτυξης (DEV)

Η παρακάτω εικόνα δείχνει τις εργασίες του εργαλείου δόμησης που μπορείτε να προσθέσετε σε μια διοχέτευση που εξάγει μια λύση από ένα περιβάλλον ανάπτυξης.

Εξαγωγή λύσης από ένα περιβάλλον ανάπτυξης (DEV).

Διοχέτευση αγωγού: Δημιουργία μιας διαχειριζόμενης λύσης

Η παρακάτω εικόνα δείχνει τις εργασίες του εργαλείου δόμησης που μπορείτε να προσθέσετε σε μια διοχέτευση που δημιουργεί μια διαχειριζόμενη λύση.

Δόμηση διαχειριζόμενης λύσης.

Διοχέτευση κυκλοφορίας: Ανάπτυξη σε ένα περιβάλλον παραγωγής (PROD)

Η παρακάτω εικόνα δείχνει τις εργασίες του εργαλείου δόμησης που μπορείτε να προσθέσετε σε μια διοχέτευση που κάνει ανάπτυξη προς ένα περιβάλλον παραγωγής.

Ανάπτυξη σε ένα περιβάλλον παραγωγής (PROD).

Δείτε επίσης

Microsoft Power Platform Build Tools για το Azure DevOps