aspnetcore/eng/scripts/RunHelix.ps1

<#
.SYNOPSIS
    Runs the specified test project on a Helix machine.
.DESCRIPTION
    This script runs the Helix msbuild task on the given project and publishes then uploads the output and runs tests on the Helix machine(s) passed in.
.PARAMETER Project
    The test project to publish and send to Helix.
.PARAMETER HelixQueues
    Set the Helix queues to use. The list is '+' or ';'-separated.
    Some supported queues:
    Debian.11.Amd64.Open
    Mariner
    AlmaLinux.8.Amd64.Open
    Ubuntu.2004.Amd64.Open
    OSX.1100.Amd64.Open
    Windows.10.Amd64.Server20H2.Open
    Windows.11.Amd64.Client.Open
    Windows.Amd64.Server2022.Open
.PARAMETER RunQuarantinedTests
    By default quarantined tests are not run. Set this to $true to run only the quarantined tests.
.PARAMETER TargetArchitecture
    The CPU architecture to build for (x64, x86, arm). Default=x64
.PARAMETER MSBuildArguments
    Additional MSBuild arguments to be passed through.
#>
[CmdletBinding(PositionalBinding = $false)]
param(
    [Parameter(Mandatory=$true)]
    [string]$Project,

    [string]$HelixQueues = "Windows.10.Amd64.Server20H2.Open",
    [switch]$RunQuarantinedTests,

    [ValidateSet('x64', 'x86', 'arm', 'arm64')]
    [string]$TargetArchitecture = "x64",

    # Capture the rest
    [Parameter(ValueFromRemainingArguments = $true)]
    [string[]]$MSBuildArguments
)

$ErrorActionPreference = 'Stop'
$ProgressPreference = 'SilentlyContinue' # Workaround PowerShell/PowerShell#2138

$NUGET_PACKAGES = $env:NUGET_PACKAGES
if ($NUGET_PACKAGES -eq $null) {
    $NUGET_PACKAGES = "$env:HOMEPATH/.nuget/packages/"
}

Set-StrictMode -Version 1

$env:BUILD_REASON="PullRequest"
$env:BUILD_SOURCEBRANCH="local"
$env:BUILD_REPOSITORY_NAME="aspnetcore"
$env:SYSTEM_TEAMPROJECT="aspnetcore"

Write-Host -ForegroundColor Yellow "If running tests that need the shared Fx, run './build -pack -all' before this."
Write-Host -ForegroundColor Yellow "If everything is up-to-date, add '/p:NoBuild=true' to this command."
Write-Host -ForegroundColor Yellow "Or, if only the test project is out-of-date, add '/p:BuildProjectReferences=false'."

$HelixQueues = $HelixQueues -replace ";", "%3B"
dotnet msbuild $Project /t:Helix /p:TargetArchitecture="$TargetArchitecture" `
    /p:HelixTargetQueues=$HelixQueues /p:RunQuarantinedTests=$RunQuarantinedTests `
    /p:_UseHelixOpenQueues=true /p:CrossgenOutput=false /p:ASPNETCORE_TEST_LOG_DIR=artifacts/log `
    /p:DoNotRequireSharedFxHelix=true /p:NUGET_PACKAGES=$NUGET_PACKAGES @MSBuildArguments