about_AzDevOps.help.txt
TOPIC
about_azdevops SHORT DESCRIPTION A module for working with Azure Devops Organizations LONG DESCRIPTION This module provides the ability to manage and work with an Azure Devops organization. Working with Projects This will walk through connecting to an Azure Devops Organization, creating a project and renaming the project. Then this will cover creating a Team within the project, making a change to that team. Finally this will cover removing everything that was created. EXAMPLES Connect-AzDevOpsOrganization -Orgname patton-tech -PAT ****** Connected to https://dev.azure.com/patton-tech/ Connect to Azure Devops New-AzDevOpsProject -Name sampleproject -Description 'A project to show how to work with Devops' id : 45ace62e-3bf1-48de-8648-2a07741f5f97 name : sampleproject description : A project to show how to work with Devops url : https://dev.azure.com/patton-tech/_apis/projects/45ace62e-3bf1-48de-8648-2a07741f5f97 state : wellFormed revision : 515330788 visibility : private lastUpdateTime : 2020-04-14T16:41:30.987Z Create a new project Get-AzDevOpsProject -ProjectId 45ace62e-3bf1-48de-8648-2a07741f5f97 ` |Update-AzDevOpsProject -Name NewProject -Abbreviation 'anp' id : 45ace62e-3bf1-48de-8648-2a07741f5f97 abbreviation : anp name : NewProject description : A project to show how to work with Devops url : https://dev.azure.com/patton-tech/_apis/projects/45ace62e-3bf1-48de-8648-2a07741f5f97 state : wellFormed revision : 515330789 _links : @{self=; collection=; web=} visibility : private defaultTeam : @{id=673d45be-8a12-4f20-8c18-61bd37e41e13; name=sampleproject Team; url=https://dev.azure.com/patton-tech/_apis/projects/45ace62e-3bf1-48de-8648-2a07741f5f97/teams/673d45be-8a12-4f20-8c18-61bd37e41e13} lastUpdateTime : 2020-04-14T16:42:11.04Z Update a project Get-AzDevOpsProject -ProjectId 45ace62e-3bf1-48de-8648-2a07741f5f97 ` |Get-AzDevOpsTeam id : 673d45be-8a12-4f20-8c18-61bd37e41e13 name : NewProject Team url : https://dev.azure.com/patton-tech/_apis/projects/45ace62e-3bf1-48de-8648-2a07741f5f97/teams/673d45be-8a12-4f20-8c18-61bd37e41e13 description : The default project team. identityUrl : https://spsprodeus27.vssps.visualstudio.com/A098ee851-8ad4-482f-834b-e68ea8489c4d/_apis/Identities/673d45be-8a12-4f20-8c18-61bd37e41e13 projectName : NewProject projectId : 45ace62e-3bf1-48de-8648-2a07741f5f97 Get a list of default teams Get-AzDevOpsProject -ProjectId 45ace62e-3bf1-48de-8648-2a07741f5f97 ` |New-AzDevOpsTeam -Name 'DevTeam' -Description 'A team for developers' id : c28e74b4-c403-4d9d-a0df-515a423c5f0a name : DevTeam url : https://dev.azure.com/patton-tech/_apis/projects/45ace62e-3bf1-48de-8648-2a07741f5f97/teams/c28e74b4-c403-4d9d-a0df-515a423c5f0a description : A team for developers identityUrl : https://spsprodeus27.vssps.visualstudio.com/A098ee851-8ad4-482f-834b-e68ea8489c4d/_apis/Identities/c28e74b4-c403-4d9d-a0df-515a423c5f0a projectName : NewProject projectId : 45ace62e-3bf1-48de-8648-2a07741f5f97 identity : @{id=c28e74b4-c403-4d9d-a0df-515a423c5f0a; descriptor=Microsoft.TeamFoundation.Identity;S-1-9-1551374245-786869317-4047232584-2252876295-1948213143-1-1214940583-4291806031-3104285065-2988544660; subjectDescriptor=vssgp.Uy0xLTktMTU1MTM3NDI0NS03ODY4NjkzMTctNDA0NzIzMjU4NC0yMjUyODc2Mjk1LTE5NDgyMTMxNDMtMS0xMjE0OTQwNTgzLTQyOTE4MDYwMzEtMzEwNDI4NTA2NS0yOTg4NTQ0NjYw; providerDisplayName=[NewProject]\DevTeam; isActive=True; isContainer=True; members=System.Object[]; memberOf=System.Object[]; masterId=c28e74b4-c403-4d9d-a0df-515a423c5f0a; properties=; resourceVersion=2; metaTypeId=255} Create a new team Get-AzDevOpsProject -ProjectId 45ace62e-3bf1-48de-8648-2a07741f5f97 ` |Get-AzDevOpsTeam id : c28e74b4-c403-4d9d-a0df-515a423c5f0a name : DevTeam url : https://dev.azure.com/patton-tech/_apis/projects/45ace62e-3bf1-48de-8648-2a07741f5f97/teams/c28e74b4-c403-4d9d-a0df-515a423c5f0a description : A team for developers identityUrl : https://spsprodeus27.vssps.visualstudio.com/A098ee851-8ad4-482f-834b-e68ea8489c4d/_apis/Identities/c28e74b4-c403-4d9d-a0df-515a423c5f0a projectName : NewProject projectId : 45ace62e-3bf1-48de-8648-2a07741f5f97 id : 673d45be-8a12-4f20-8c18-61bd37e41e13 name : NewProject Team url : https://dev.azure.com/patton-tech/_apis/projects/45ace62e-3bf1-48de-8648-2a07741f5f97/teams/673d45be-8a12-4f20-8c18-61bd37e41e13 description : The default project team. identityUrl : https://spsprodeus27.vssps.visualstudio.com/A098ee851-8ad4-482f-834b-e68ea8489c4d/_apis/Identities/673d45be-8a12-4f20-8c18-61bd37e41e13 projectName : NewProject projectId : 45ace62e-3bf1-48de-8648-2a07741f5f97 List teams in the project Remove-AzDevOpsTeam -ProjectId 45ace62e-3bf1-48de-8648-2a07741f5f97 -TeamId c28e74b4-c403-4d9d-a0df-515a423c5f0a Confirm Are you sure you want to perform this action? Performing the operation "Remove team DevTeam from NewProject Azure Devops Projects" on target "Delete". [Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "Y"): y Team : c28e74b4-c403-4d9d-a0df-515a423c5f0a removed from Project : 45ace62e-3bf1-48de-8648-2a07741f5f97 Delete a team from the project Get-AzDevOpsProject -ProjectId 45ace62e-3bf1-48de-8648-2a07741f5f97 ` |Get-AzDevOpsTeam id : 673d45be-8a12-4f20-8c18-61bd37e41e13 name : NewProject Team url : https://dev.azure.com/patton-tech/_apis/projects/45ace62e-3bf1-48de-8648-2a07741f5f97/teams/673d45be-8a12-4f20-8c18-61bd37e41e13 description : The default project team. identityUrl : https://spsprodeus27.vssps.visualstudio.com/A098ee851-8ad4-482f-834b-e68ea8489c4d/_apis/Identities/673d45be-8a12-4f20-8c18-61bd37e41e13 projectName : NewProject projectId : 45ace62e-3bf1-48de-8648-2a07741f5f97 list teams in the project Remove-AzDevOpsProject -Project (Get-AzDevOpsProject -ProjectId 45ace62e-3bf1-48de-8648-2a07741f5f97) Confirm Are you sure you want to perform this action? Performing the operation "Delete NewProject from https://dev.azure.com/patton-tech/ Azure Devops" on target "Remove". [Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "Y"): y Project NewProject removed Remove a project NOTE You will need to create the PAT within the Azure Devops Portal before you are able to connect. - 1. Login to your Azure Devops Organization - 2. Access your account profile and select User Settings - 3. Select Personal Access Tokens then click New Token - 4. Provide a name, choose the organization to use, and set an expiration - 5. Define your scopes - 6. Copy the token and store it in a safe location TROUBLESHOOTING NOTE Most issues relate to security, as the module stands now, you will need to make sure that your PAT has enough permissions to perform the tasks required. SEE ALSO <https://github.com/Azure-Devops-PowerShell-Module/AzDevOps/wiki> |