Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Update devops-build-tool-tasks.md #2719

Open
wants to merge 3 commits into
base: main
Choose a base branch
from
Open

Update devops-build-tool-tasks.md #2719

Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
b11de44
Add AddToolsToPath input to PowerPlatformToolInstaller
ryanmichaeljames Dec 10, 2024
8d71c17
Add variables set by PowerPlatformSetConnectionVariables
ryanmichaeljames Dec 10, 2024
1cda473
Remove whitespace
ryanmichaeljames Dec 10, 2024
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
21 changes: 18 additions & 3 deletions power-platform/alm/devops-build-tool-tasks.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ ms.subservice: alm
ms.date: 12/03/2024
ms.reviewer: pehecke
ms.topic: article
search.audienceType:
search.audienceType:
- developer
---

Expand Down Expand Up @@ -38,6 +38,14 @@ to the versions of the tools that are required for the pipeline to run properly.
displayName: 'Power Platform Tool Installer'
```

```yml
# 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
```

```yml
# Installs specific versions of the Power Platform Build Tools
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.tool-installer.PowerPlatformToolInstaller@2
Expand All @@ -52,6 +60,7 @@ to the versions of the tools that are required for the pipeline to run properly.
| Parameters | Description |
|---------------|---------------|
| `DefaultVersion`<br/>Use default tool versions | Set to **true** to use the default version of all tools, otherwise **false**. Required (and **false**) when any tool versions are specified. |
| `AddToolsToPath`<br/>Add Tools To Path | Adds the pac cli to the `PATH` environment variable. Enables you to use pac cli from script tasks without needing to set up the path manually. |
| `PowerAppsAdminVersion`<br/>`XrmToolingPackageDeploymentVersion`<br/>`MicrosoftPowerAppsCheckerVersion`<br/>`CrmSdkCoreToolsVersion`<br/>Tool version | The specific version of the tool to use. |

### Power Platform WhoAmI
Expand All @@ -65,7 +74,7 @@ Verifies a Power Platform environment service connection by connecting and makin
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.whoami.PowerPlatformWhoAmi@2
displayName: 'Power Platform WhoAmI'

inputs:
inputs:
# Service Principal/client secret (supports MFA)
authenticationType: PowerPlatformSPN
PowerPlatformSPN: 'My service connection'
Expand Down Expand Up @@ -466,7 +475,13 @@ Alternatively a powershell inline task script $(Get-Date -Format yyyy.MM.dd.HHmm

### Power Platform Set Connection Variables

Sets BuildTools.* variables to provide custom script tasks access to use the service connection as a single source of truth.
Sets `PowerPlatformSetConnectionVariables.BuildTools.*` variables to provide custom script tasks access to use the service connection as a single source of truth.

The following variables are set:
- `PowerPlatformSetConnectionVariables.BuildTools.TenantId`
- `PowerPlatformSetConnectionVariables.BuildTools.ApplicationId`
- `PowerPlatformSetConnectionVariables.BuildTools.ClientSecret`
- `PowerPlatformSetConnectionVariables.BuildTools.DataverseConnectionString`

#### YAML snippet (SetConnectionVariables)

Expand Down
Loading