Implement -VSTeamEnvironment

[mnieto]

Proposal

I wanted to create Add, Get, Remove, Update -VSTeamEnvironment cmdlets API documentation

I have a preview working version of Get-VSTeamEnvironment with this syntax

Get-VSTeamEnvironment [-Id] -ProjectName

Discussion

When I went to the types folder to add the Environment type, I found that already exists a type definition in vsteam_lib.Environment.ps1xml that corresponds with the Release environment type

• Should I refactor and name current Environment as ReleaseEnvironment.
• Or maybe I could name the new type TaskEnvironment, or AgentsEnvironment (because the area where the API endpoint is located
• Other suggestion...?

Solved Problem

Environments are an important piece in the deploy jobs in the yaml pipelines Implementing this cmdlets opens the opportunity to implement also getting the list of deployments into an specific environment

Additional info / code snippets?

No response

[jikuja]

I suggest also adding support for role assignments(for environment security) to circumvent some problems(1) Azure devops has: *https://dev.azure.com/{organization}/_apis/securityroles/scopes/distributedtask.globalenvironmentreferencerole/roleassignments/resources/{something}

• https://learn.microsoft.com/en-us/rest/api/azure/devops/securityroles/roleassignments/set-role-assignment?view=azure-devops-rest-7.1

(1) https://developercommunity.visualstudio.com/t/Environments-Permissions-changing-not-po/872257