Add ability to use Queue-Pipeline.ps1 with an empty SourceBranch and …

…document

eng/common/scripts/Queue-Pipeline.ps1

@@ -1,3 +1,45 @@
+<#
+.SYNOPSIS
+Queues an Azure DevOps Pipeline run optionally canceling similar runs
+
+.PARAMETER Organization
+Azure DevOps organization name
+
+.PARAMETER Project
+Azure DevOps project name
+
+.PARAMETER SourceBranch
+Source branch use when executing the DevOps pipeline. Specifying an empty string
+will result in queuing of the run with the default branch configured for the
+pipeline.
+
+.PARAMETER DefinitionId
+Pipline definition ID
+
+.PARAMETER CancelPreviousBuilds
+Requires a value for SourceBranch. Cancel previous builds before queuing the new 
+build.
+
+.PARAMETER VsoQueuedPipelines
+Variable name to set in DevOps for the queued pipeline links
+
+.PARAMETER Base64EncodedAuthToken
+Auth token for Azure DevOps API
+
+.PARAMETER BuildParametersJson
+Additional build parameters to provide to the pipeline execution.
+
+Of the format:
+
+```json
+{
+  "variable1": "value1",
+  "variable2": "value2"
+}
+```
+
+#>
+
 [CmdletBinding(SupportsShouldProcess = $true)]
 param(
   [Parameter(Mandatory = $true)]
@@ -25,7 +67,9 @@ param(
 
 . (Join-Path $PSScriptRoot common.ps1)
 
-if ($CancelPreviousBuilds)
+# Skip if SourceBranch is empty because it we cannot generate a target branch
+# name from an empty string.
+if ($CancelPreviousBuilds -and $SourceBranch)
 {
   try {
     $queuedBuilds = Get-DevOpsBuilds -BranchName "refs/heads/$SourceBranch" -Definitions $DefinitionId `