gitlab-api/New-GitLabProjectIssue.ps1 at master · episource/gitlab-api · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
function New-GitLabProjectIssue
{
  <#
      .SYNOPSIS
      Creates a new project issue.
      .DESCRIPTION
      The New-GitLabProjectIssue functions creates a new function in the specified project.
      .EXAMPLE
      New-GitLabProjectIssue -ProjectID 20 -Title 'Important Issue'
      ---------------------------------------------------------------
      Creates the Issue title 'Important Issue' in project woth ID 20
      .EXAMPLE
      New-GitLabProjectIssue -ProjectID 20 -Title 'Important Issue' -PassThru
      ---------------------------------------------------------------
      Creates the Issue title 'Important Issue' in project woth ID 20 and returns the new issue.
  #>
  [CmdletBinding()]
  [Alias()]
  [OutputType()]
  Param
  (
    #The Id of the project
    [Parameter(HelpMessage = 'ProjectID',
    Mandatory = $true)]
    [Alias('ID')]
    [int]$ProjectID,

    # The title of the new issue
    [Parameter(Helpmessage = 'The title of an issue',
    mandatory = $true)]
    [string]$Title,

    # The description of the new issue
    [Parameter(Helpmessage = 'The description of the issue',
    mandatory = $false)]
    [string]$Description,

    # Specify the user to assign the issue
    [Parameter(Helpmessage = 'The ID of a user to assign issue',
    mandatory = $false)]
    [Alias('assignee_id')]
    [int]$AssigneeID,

    # Specify the ID of the milestone to assign the issue
    [Parameter(Helpmessage = 'The ID of a milestone to assign issue',
    mandatory = $false)]
    [Alias('milestone_id')]
    [int]$MilestoneID,

    # Specify the labels for the new issue
    [Parameter(HelpMessage = 'label names for an issue',
    mandatory = $false)]
    [string[]]$Labels,

    # Specify the date the issue was created
    [Parameter(Helpmessage = 'the date the issue was created',
    mandatory = $false)]
    [alias('created_at')]
    [datetime]$CreatedAt,

    # Specify the due date for the issue
    [Parameter(Helpmessage = 'the due date of the issue',
    mandatory = $false)]
    [alias('due_date')]
    [datetime]$DueDate,

    # Specify Existing GitlabConnector
    [Parameter(HelpMessage = 'Specify Existing GitlabConnector',
        Mandatory = $false,
    DontShow = $true)]
    [psobject]$GitlabConnect = (Get-GitlabConnect),

    # Passthru the created Issue
    [Parameter(HelpMessage = 'Passthru the created project',
    Mandatory = $false)]
    [switch]$PassThru
  )

  $httpmethod = 'post'
  $apiurl = "projects/$ProjectID/issues"
  $parameters = @{
    title = $Title
  }

  if($Description)
  {
    $parameters.description = $Description
  }

  if($AssigneeID)
  {
    $parameters.'assignee_id' = $AssigneeID
  }

  if ($MilestoneID)
  {
    $parameters.'milestone_id' = $MilestoneID
  }

  if($Labels)
  {
    $parameters.labels = @($Labels) -join ','
  }

  if($CreatedAt)
  {
    $parameters.'created_at' = $CreatedAt.ToUniversalTime().tostring('s') +'Z'
  }

  if($DueDate)
  {
    $parameters.'due_date' = $DueDate.tostring("yyyy'-'MM'-'dd")
  }

  $newissue = $GitlabConnect.callapi($apiurl,$httpmethod,$parameters)

  if($PassThru)
  {
    return $newissue
  }
}