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

Άρθρο
03/29/2024

Οι διαθέσιμες εργασίες δόμησης περιγράφονται στις ακόλουθες ενότητες. Στη συνέχεια, θα παρουσιάσουμε ορισμένα παραδείγματα του Azure Pipeline που κάνουν χρήση αυτών των εργασιών. Για πληροφορίες σχετικά με τα εργαλεία δόμησης και τον τρόπο λήψης τους, ανατρέξτε στο θέμα Εργαλεία δόμησης 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@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

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

Παράμετροι	Περιγραφή
`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@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'

Παράμετροι (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@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'

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

Παράμετροι	Περιγραφή
`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 API Checker.
`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` Σύνολο κανόνων	(Απαιτείται) Καθορίστε το σύνολο κανόνων που θα εφαρμοστεί. Είναι διαθέσιμα τα δύο παρακάτω σύνολα κανόνων: Έλεγχος λύσης: Το ίδιο σύνολο κανόνων εκτελείται από τo Power Apps maker portal. 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@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

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

Παράμετροι	Περιγραφή
`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@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

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

Παράμετροι	Περιγραφή
`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@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

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

Παράμετροι	Περιγραφή
`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)(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@2
  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@2
  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@2
  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@2
  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@2
  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@2
  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@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

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

Παράμετροι	Περιγραφή
`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@2
  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@2
  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@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'
    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).
`ModelVersion` Μοντέλο δεδομένων τοποθεσίας	Υποδεικνύει εάν τα δεδομένα τοποθεσίας προς αποστολή θα χρησιμοποιήσουν το τυπικό (`1`) ή το βελτιωμένο μοντέλο δεδομένων (`2`). Η προεπιλεγμένη τιμή είναι '1'.

Λήψη 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.
`ModelVersion` Μοντέλο δεδομένων τοποθεσίας	Υποδεικνύει εάν τα δεδομένα τοποθεσίας προς αποστολή θα χρησιμοποιήσουν το τυπικό (`1`) ή το βελτιωμένο μοντέλο δεδομένων (`2`). Η προεπιλεγμένη τιμή είναι '1'.

Εργασίες καταλόγου για 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 Δημιουργία εργαλείων για Azure DevOps

Κοινή χρήση μέσω

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

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

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

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

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

Power Platform WhoAmI

Τμήμα κώδικα YAML (WhoAmI)

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

Έλεγχος ποιότητας

Power Platform Checker

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Τμήμα κώδικα YAML (SetConnectionVariables)

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

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

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

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

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

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

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

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

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

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

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

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

Τμήμα κώδικα YAML (AssignUser-env)

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Τμήμα κώδικα YAML (exportdata-env)

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

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

Τμήμα κώδικα YAML (importdata-env)

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

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

Λήψη του PAPortal Power Platform

Τμήμα κώδικα YAML (download-paportal)

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

Λήψη PAPortal Power Platform