Skip to content

ravensorb/Posh-AzureDevOps

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

47 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Posh-AzureDevOps

Powershell Module for working with Azure DevOps

Getting Started

Install the Power Shell Model from the gallery

Install-Module -Name Posh-AzureDevOps

or Clone/Download the files from the repository into a specific folder and then run the script ".\Import-AzDoModules.ps1".

This will import all of the modules correctly so they can be executed like any standard powershell command.

Next use the Connect-AzDo command to create a connection to your Azure DevOps instance. This will create a connection and setup the environment so all other calls can be made without needed to pass connection details in explicity.

$conn = Conntet-AzDo -OrganizationUrl <Org URL> -ProjectName <project name> -PAT <PAT token with full access>

Get-AzDoUsers

Overview

This module provides a way to work with most of Azure DevOps from PowerShell. It is broken out by functional areas (Builds, Libraries, Projects, Releases, Repos, Security, and Work Items).

Connections

  • Connect-AzDo

Build Definitions

  • Add-AzDoBuildPipelineVariable
  • Get-AzDoBuildDefinition
  • Get-AzDoBuildPipelineVariables
  • Get-AzDoBuilds
  • Get-AzDoBuildWorkItems
  • Remove-AzDoBuildPipelineVariable

Libraries

  • Add-AzDoVariableGroupVariable
  • Add-AzDoVariableGroupResourceAssignment
  • Get-AzDoVariableGroupResourceAssignment
  • Get-AzDoVariableGroupRoleDefinitions
  • Get-AzDoVariableGroups
  • Import-AzDoVariableGroupVariables
  • New-AzDoVariableGroupVariables
  • Remove-AzDoVariableGroupVariable
  • Remove-AzDoVariableGroup
  • Remove-AzDoVariableGroupResourceAssignment
  • Set-AzDoVariableGroupPermissionInheritance

Projects

  • Get-AzDoProjectDetails
  • Get-AzDoProjects

Release Definitions

  • Add-AzDoReleasePipelineVaraibleGroup
  • Add-AzDoReleasePipelineVariable
  • Get-AzDoRelease
  • Get-AzDoReleaseDefinition
  • Get-AzDoReleasePipelineVariableGroups
  • Get-AzDoReleasePipelineVariables
  • Get-AzDoReleaseWorkItems
  • Remove-AzDoReleasePipelineVariable

Repositories

  • Get-AzDoRepoBranches

Security

  • Add-AzDoSecurityGroupMemeber
  • Get-AzDoSecurityGroupMemebers
  • Get-AzDoSecurityGroups
  • Get-AzDoTeamMembers
  • Get-AzDoTeams
  • Get-AzDoUserDetails
  • Get-AzDoUsers
  • New-AzDoSecurityGroup
  • New-AzDoTeam
  • Remove-AzDoSecurityGroup
  • Remove-AzDoSecurityGroupMemeber
  • Remove-AzDoTeam

Utility

  • Connect-AzDo
  • Get-AzDoActiveConnection

Examples

Working With Libraries

For some quick background, check out this blog article: http://itramblings.com/2019/03/managing-vsts-tfs-release-definition-variables-from-powershell/

Import-AzDoVariableGroupVariables

This script will do a bulk import from a CSV file into a specific Azure DevOps Variable group.

Parameters

  • AzDoConnect - The current connection to AZDO
  • csvFile - The full path to the csv file (see below for format)
  • VariableGroupName - The name of the variable group in the library to work with
  • EnvrionmentNameFilter - The specific environment to import (set to * to import everything in the csv file)
  • Reset - Tells the script to clear out all existing values in the variable group before importing new value
  • Force - Tells the script to create the variable group if it does not already exist

CSV File Format

The format of the CSV file must be as follows "Variable","Value","Env" Example:

SomeVariable, SomeValue, DEV01
SomeVariable, SomeValue, DEV02
SomeVariable, SomeValue, UAT
SomeVariable, SomeValue, PROD

About

Powershell Scripts related to Azure DevOps

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published