εργασίες εργαλείων δόμησης του Microsoft Power Platform

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

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

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

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

Αυτή η εργασία απαιτείται να προστεθεί μία φορά πριν από οποιεσδήποτε άλλες εργασίες εργαλείων δόμησης του Power Platform Build Tools στις διοχετεύσεις δόμησης και κυκλοφορίας. Αυτή η εργασία εγκαθιστά ένα σύνολο εργαλείων για το 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 default Power Platform Build Tools and adds the pac cli to the `PATH` environment variable
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.tool-installer.PowerPlatformToolInstaller@2
  displayName: 'Power Platform Tool Installer'
  inputs:
    AddToolsToPath: true

# 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) όταν καθορίζονται οποιεσδήποτε εκδόσεις εργαλείων.
AddToolsToPath Προσθήκη εργαλείων στη διαδρομή	Προσθέτει το pac cli στη PATH μεταβλητή περιβάλλοντος. Σας επιτρέπει να χρησιμοποιείτε το pac cli από εργασίες δέσμης ενεργειών χωρίς να χρειάζεται να ρυθμίσετε τη διαδρομή με μη αυτόματο τρόπο.
PowerAppsAdminVersion XrmToolingPackageDeploymentVersion MicrosoftPowerAppsCheckerVersion CrmSdkCoreToolsVersion Έκδοση εργαλείου	Η συγκεκριμένη έκδοση του εργαλείου που θα χρησιμοποιηθεί.

WhoAmI πλατφόρμας Power

Επαληθεύει μια σύνδεση υπηρεσίας περιβάλλοντος του 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

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

Τμήμα κώδικα 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 Σύνδεση υπηρεσίας	(Απαιτείται) Για τη χρήση του εργαλείου ελέγχου Power Platform απαιτείται μια σύνδεση σε ένα περιβάλλον Microsoft 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 Σύνολο κανόνων	(Απαιτείται) Καθορίστε το σύνολο κανόνων που θα εφαρμοστεί. Είναι διαθέσιμα τα δύο παρακάτω σύνολα κανόνων: Έλεγχος λύσης: Αυτό το σύνολο κανόνων είναι το ίδιο που εκτελείται από την πύλη Power Apps maker. Marketplace: Το εκτεταμένο σύνολο κανόνων που χρησιμοποιείται για την πιστοποίηση μιας εφαρμογής για να μπορεί να δημοσιευτεί στο Marketplace.
ErrorLevel Επίπεδο σφάλματος	Σε συνδυασμό με την παράμετρο ορίου σφάλματος καθορίζει τη σοβαρότητα των σφαλμάτων και των προειδοποιήσεων που επιτρέπονται. Οι υποστηριζόμενες τιμές ορίων είναι <level>IssueCount όπου level=Κρίσιμη, Υψηλή, Μέση, Χαμηλή και Ενημερωτική.
ErrorThreshold Όριο σφάλματος	Καθορίζει τον αριθμό των σφαλμάτων (>=0) ενός καθορισμένου επιπέδου που επιτρέπεται για τον έλεγχο να διαβιβάσει τις λύσεις που ελέγχονται.
FailOnPowerAppsCheckerAnalysisError Αποτυχία σε περίπτωση σφάλματος	Όταν true, αποτύχει εάν η ανάλυση του Power Apps Checker επιστραφεί ως Failed ή FinishedWithErrors.
ArtifactDestinationName Όνομα αντικειμένου σχεδίασης DevOps	Καθορίστε το όνομα Azure Artifacts για το αρχείο .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

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 Μετατροπή σε διαχειριζόμενο	Απαρχαιωμένος. Το σύστημα θα μετατρέψει μη διαχειριζόμενα στοιχεία λύσης σε διαχειριζόμενα κατά την εισαγωγή μιας διαχειριζόμενης λύσης.
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 προεπιλογή για τις εργασίες.

Note

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

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

Λύση Εξαγωγής 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

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

Ορίζονται οι ακόλουθες μεταβλητές:

• PowerPlatformSetConnectionVariables.BuildTools.TenantId
• PowerPlatformSetConnectionVariables.BuildTools.ApplicationId
• PowerPlatformSetConnectionVariables.BuildTools.ClientSecret
• PowerPlatformSetConnectionVariables.BuildTools.DataverseConnectionString

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

Παράμετροι (ΟρισμόςΜεταβλητώνΣύνδεσης)

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

Note

Όταν χρησιμοποιείτε τον τύπο ελέγχου ταυτότητας ονόματος χρήστη/κωδικού πρόσβασης, θα απαιτείται το αναγνωριστικό εφαρμογής και η διεύθυνση 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 (Create-env)

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 Γλώσσα	(Απαιτείται) Η βασική γλώσσα στο περιβάλλον.
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'

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

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

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

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

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

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

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

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

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

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

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

Παράμετροι	Περιγραφή
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 Φιλικό όνομα	Το φιλικό όνομα του περιβάλλοντος προορισμού.
SkipAuditData SkipAuditData	Εάν θα παραλείψετε τα δεδομένα ελέγχου κατά τη λειτουργία αντιγραφής. (αληθές/ψευδές).
MaxAsyncWaitTime Μέγιστος χρόνος αναμονής	Ο μέγιστος χρόνος αναμονής σε λεπτά για την ασύγχρονη λειτουργία. Η προεπιλογή είναι 60 λεπτά (1 ώρα), όπως και Azure DevOps προεπιλογή για τις εργασίες.

Επαναφορά περιβάλλοντος 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

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

Αποστολή PAPortal Power Platform

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

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

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

Note

Προς το παρόν, οι εργασίες καταλόγου για το 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

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

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

Παράμετροι	Περιγραφή
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, ολοκληρώστε τα εργαστήρια των εργαλείων κατασκευής, τα οποία μπορείτε να κατεβάσετε από το GitHub.

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

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

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

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

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

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

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

Δείτε επίσης

Microsoft Power Platform Εργαλεία δόμησης για Azure DevOps