Merge pull request #59 from WeAreInSpark/dylan-fix

fixed documentation and collectionuri parameter

Author: Dylan-Prins

AzureDevOpsPowerShell/Private/Validate-CollectionUri.ps1

@@ -0,0 +1,15 @@
+function Validate-CollectionUri {
+  [CmdletBinding()]
+  param (
+    # Parameter help description
+    [Parameter(Mandatory)]
+    [string]
+    $CollectionUri
+  )
+
+  if ($CollectionUri -notmatch '^https:\/\/dev\.azure\.com\/\w+$') {
+    Write-AzdoError "CollectionUri must be a valid Azure DevOps collection URI starting with 'https://dev.azure.com/'"
+  } else {
+    $true
+  }
+}

AzureDevOpsPowerShell/Public/Api/ApprovalsAndChecks/CheckConfigurations/Add-AzDoPipelineBranchControl.ps1

@@ -38,6 +38,7 @@ function Add-AzDoPipelineBranchControl {
   param (
     # Collection Uri of the organization
     [Parameter(Mandatory, ValueFromPipelineByPropertyName)]
+    [ValidateScript({ Validate-CollectionUri -CollectionUri $_ })]
     [string]
     $CollectionUri,
 

AzureDevOpsPowerShell/Public/Api/Build/GeneralSettings/Set-AzDOProjectSetting.ps1

@@ -27,6 +27,7 @@ function Set-AzDoProjectSetting {
   param (
     # Collection uri of the organization. Can be set with the predefined variable from Azure DevOps.
     [Parameter(Mandatory)]
+    [ValidateScript({ Validate-CollectionUri -CollectionUri $_ })]
     [string]
     $CollectionUri,
 

AzureDevOpsPowerShell/Public/Api/Core/Projects/Get-AzDoProject.ps1

@@ -50,6 +50,7 @@ function Get-AzDoProject {
   param (
     # Collection Uri of the organization
     [Parameter(Mandatory, ValueFromPipelineByPropertyName)]
+    [ValidateScript({ Validate-CollectionUri -CollectionUri $_ })]
     [string]
     $CollectionUri,
 

AzureDevOpsPowerShell/Public/Api/Core/Projects/New-AzDoProject.ps1

@@ -35,6 +35,7 @@ function New-AzDoProject {
     # Collection URI. e.g. https://dev.azure.com/contoso.
     # Azure Pipelines has a predefined variable for this.
     [Parameter(Mandatory, ValueFromPipelineByPropertyName)]
+    [ValidateScript({ Validate-CollectionUri -CollectionUri $_ })]
     [string]
     $CollectionUri,
 

AzureDevOpsPowerShell/Public/Api/Core/Projects/Remove-AzDoProject.ps1

@@ -36,6 +36,7 @@ function Remove-AzDoProject {
     # Collection URI. e.g. https://dev.azure.com/contoso.
     # Azure Pipelines has a predefined variable for this.
     [Parameter(Mandatory, ValueFromPipelineByPropertyName)]
+    [ValidateScript({ Validate-CollectionUri -CollectionUri $_ })]
     [string]
     $CollectionUri,
 

AzureDevOpsPowerShell/Public/Api/DistributedTask/VariableGroups/Add-AzDoVariableGroupVariable.ps1

@@ -41,6 +41,7 @@ function Add-AzDoVariableGroupVariable {
   param (
     # Collection Uri of the organization
     [Parameter(Mandatory, ValueFromPipelineByPropertyName)]
+    [ValidateScript({ Validate-CollectionUri -CollectionUri $_ })]
     [string]
     $CollectionUri,
 

AzureDevOpsPowerShell/Public/Api/DistributedTask/VariableGroups/Get-AzDoVariableGroup.ps1

@@ -31,6 +31,7 @@ function Get-AzDoVariableGroup {
   param (
     # Collection Uri of the organization
     [Parameter(Mandatory, ValueFromPipelineByPropertyName)]
+    [ValidateScript({ Validate-CollectionUri -CollectionUri $_ })]
     [string]
     $CollectionUri,
 

AzureDevOpsPowerShell/Public/Api/DistributedTask/VariableGroups/New-AzDoVariableGroup.ps1

@@ -40,6 +40,7 @@ function New-AzDoVariableGroup {
   param (
     # Collection Uri of the organization
     [Parameter(Mandatory)]
+    [ValidateScript({ Validate-CollectionUri -CollectionUri $_ })]
     [string]
     $CollectionUri,
 

AzureDevOpsPowerShell/Public/Api/Environments/Environments/Get-AzDoEnvironment.ps1

@@ -37,6 +37,7 @@ function Get-AzDoEnvironment {
   param (
     # Collection Uri of the organization
     [Parameter(Mandatory, ValueFromPipelineByPropertyName, ValueFromPipeline)]
+    [ValidateScript({ Validate-CollectionUri -CollectionUri $_ })]
     [string]
     $CollectionUri,