Public/Add-VSTeamWorkItemIterationPermission.ps1
|
function Add-VSTeamWorkItemIterationPermission { [CmdletBinding(DefaultParameterSetName = 'ByProjectAndIterationIdAndUser')] param( [parameter(Mandatory=$true,ParameterSetName="ByProjectAndIterationIdAndDescriptor")] [parameter(Mandatory=$true,ParameterSetName="ByProjectAndIterationIdAndGroup")] [parameter(Mandatory=$true,ParameterSetName="ByProjectAndIterationIdAndUser")] [parameter(Mandatory=$true,ParameterSetName="ByProjectAndIterationPathAndDescriptor")] [parameter(Mandatory=$true,ParameterSetName="ByProjectAndIterationPathAndUser")] [parameter(Mandatory=$true,ParameterSetName="ByProjectAndIterationPathAndGroup")] [VSTeamProject]$Project, [parameter(Mandatory=$true,ParameterSetName="ByProjectAndIterationIdAndDescriptor")] [parameter(Mandatory=$true,ParameterSetName="ByProjectAndIterationIdAndGroup")] [parameter(Mandatory=$true,ParameterSetName="ByProjectAndIterationIdAndUser")] [int]$IterationID, [parameter(Mandatory=$true,ParameterSetName="ByProjectAndIterationPathAndDescriptor")] [parameter(Mandatory=$true,ParameterSetName="ByProjectAndIterationPathAndUser")] [parameter(Mandatory=$true,ParameterSetName="ByProjectAndIterationPathAndGroup")] [string]$IterationPath, [parameter(Mandatory=$true,ParameterSetName="ByProjectAndIterationIdAndDescriptor")] [parameter(Mandatory=$true,ParameterSetName="ByProjectAndIterationPathAndDescriptor")] [string]$Descriptor, [parameter(Mandatory=$true,ParameterSetName="ByProjectAndIterationIdAndGroup")] [parameter(Mandatory=$true,ParameterSetName="ByProjectAndIterationPathAndGroup")] [VSTeamGroup]$Group, [parameter(Mandatory=$true,ParameterSetName="ByProjectAndIterationPathAndUser")] [parameter(Mandatory=$true,ParameterSetName="ByProjectAndIterationIdAndUser")] [VSTeamUser]$User, [parameter(Mandatory=$true,ParameterSetName="ByProjectAndIterationIdAndDescriptor")] [parameter(Mandatory=$true,ParameterSetName="ByProjectAndIterationIdAndGroup")] [parameter(Mandatory=$true,ParameterSetName="ByProjectAndIterationIdAndUser")] [parameter(Mandatory=$true,ParameterSetName="ByProjectAndIterationPathAndDescriptor")] [parameter(Mandatory=$true,ParameterSetName="ByProjectAndIterationPathAndUser")] [parameter(Mandatory=$true,ParameterSetName="ByProjectAndIterationPathAndGroup")] [VSTeamWorkItemIterationPermissions]$Allow, [parameter(Mandatory=$true,ParameterSetName="ByProjectAndIterationIdAndDescriptor")] [parameter(Mandatory=$true,ParameterSetName="ByProjectAndIterationIdAndGroup")] [parameter(Mandatory=$true,ParameterSetName="ByProjectAndIterationIdAndUser")] [parameter(Mandatory=$true,ParameterSetName="ByProjectAndIterationPathAndDescriptor")] [parameter(Mandatory=$true,ParameterSetName="ByProjectAndIterationPathAndUser")] [parameter(Mandatory=$true,ParameterSetName="ByProjectAndIterationPathAndGroup")] [VSTeamWorkItemIterationPermissions]$Deny ) process { # SecurityID: bf7bfa03-b2b7-47db-8113-fa2e002cc5b1 # Token: vstfs:///Classification/Node/862eb45f-3873-41d7-89c8-4b2f8802eaa9 (https://dev.azure.com/<organization>/<project>/_apis/wit/classificationNodes/Iterations) # "token": "vstfs:///Classification/Node/ae76de05-8b53-4e02-9205-e73e2012585e:vstfs:///Classification/Node/f8c5b667-91dd-4fe7-bf23-3138c439d07e", $securityNamespaceId = "bf7bfa03-b2b7-47db-8113-fa2e002cc5b1" if ($IterationID) { $iteration = Get-VSTeamClassificationNode -ProjectName $Project.Name -Depth 0 -Ids $IterationID } if ($IterationPath) { $iteration = Get-VSTeamClassificationNode -ProjectName $Project.Name -Depth 0 -Path $IterationPath -StructureGroup "iterations" } if (-not $iteration) { throw "Iteration not found" } if ($iteration.StructureType -ne "iteration") { throw "This is not an Iteration" } $nodes = @() $nodes += $iteration while ($iteration.ParentUrl) { $path = $iteration.ParentUrl -ireplace ".*(classificationNodes/Iterations)\/?" if ($path.length -gt 0) { # We have a Path to resolve $iteration = Get-VSTeamClassificationNode -ProjectName $Project.Name -Depth 0 -Path $path -StructureGroup "Iterations" } else { # We need to get the "root" node now $iteration = Get-VSTeamClassificationNode -ProjectName $Project.Name -Depth 0 -StructureGroup "Iterations" } $nodes += $iteration } # Build Token from Path [array]::Reverse($nodes) $token = ($nodes | ForEach-Object { "vstfs:///Classification/Node/$($_.Identifier)" }) -join ":" # Resolve Group to Descriptor if ($Group) { $Descriptor = _getDescriptorForACL -Group $Group } # Resolve User to Descriptor if ($User) { $Descriptor = _getDescriptorForACL -User $User } Add-VSTeamAccessControlEntry -SecurityNamespaceId $securityNamespaceId -Descriptor $Descriptor -Token $token -AllowMask ([int]$Allow) -DenyMask ([int]$Deny) } } |