Latest Version PowerShell Gallery Issues License Discord
Latest Version Powershell Gallery GitHub issues GitHub license Discord Server

About

The AzDevOps project is designed to leverage the Azure Devops Rest API through the use of PowerShell. Currently the modules are all written in PowerShell which should make the code easier to understand and modify as needed. The project will use Semantic Versioning for modules, these version numbers should also be reflected in the tags.

Building

The AzDevOps module is composed of multiple nested modules, each module represents a specific set of APIs that are available. Each of these modules is a self-contained repository within the project and should have the same look and feel throughout. Several tools are leveraged to facilitate keeping things as uniform as possible and we will outline them below.

Documentation

This project uses PlatyPS for framing and updating the help files and external help used by the functions.

Automation

A few things within each module are automated by psake such as the functions that are exported, as well as the README file for each module.

Syntax Checking

PSScriptAnalyzer is used to check the code against a set of standards, this ensures that the code works as expected when ran.

Testing

This is currently a work in progress, but we should be leveraging pester in a future update as well as the PowerShellBuild Module. Additionally we will be leveraging Azure Pipelines to validate versions of PowerShell and OS compatability.

Publishing

The module will be available directly from GitHub, we are looking to create Tagged releases that are easy to download. Additionally the code will be available on the PowerShell Gallery for a more streamlined delivery.

AzDevOps Module

Description

This module provides the ability to manage and work with an Azure Devops organization.

AzDevOps Cmdlets

Connect-AdoOrganization

This function will connect to Azure DevOps

Get-AdoBuild

Return one or more builds from a project

Get-AdoBuildDefinition

Gets a definition, optionally at a specific revision.

Get-AdoBuildFolder

Gets a list of build definition folders

Get-AdoBuildLog

Gets the logs for a build

Get-AdoOperation

Gets an operation from the the operationId using the given pluginId.

Get-AdoProcess

Get one or more available processes

Get-AdoProject

Get one or many projects from Azure DevOps

Get-AdoProjectProperty

Get a collection of team project Property

Get-AdoTeam

Get a specific team

Get-AdoTeamMember

Get a list of members for a specific team.

Invoke-AdoEndpoint

Query Azure Devops

New-AdoBuildFolder

Creates a new folder

New-AdoProject

Queues a project to be created

New-AdoTeam

Create a team in a team project

Remove-AdoBuild

Deletes a build

Remove-AdoBuildFolder

Deletes a definition folder

Remove-AdoProject

Queues a project to be deleted

Remove-AdoTeam

Delete a team.

Start-AdoBuild

Queues a build

Update-AdoProject

Update Name, Description or Abbreviation of a project

Update-AdoTeam

Update a team’s name and/or description