< Back

Add-JIRAIssue

Fri Jan 10, 2020 9:29 pm

NAME Add-JIRAIssue



SYNOPSIS

Creates a new JIRA issue





SYNTAX

Add-JIRAIssue -IssueType <String> [-Summary <String>] [-Description <String>] [-Reporter <String>] [-Assignee

<String>] [-Versions <String[]>] [-FixVersions <String[]>] [-Components <String[]>] [-TimeEstimate <Nullable`1>]

[-Priority <String>] [-ParentTaskKey <String>] [-Properties <Hashtable>] [-Session <AtlassianSession>]

[<CommonParameters>]



Add-JIRAIssue -Project <JIRAProject> -IssueType <String> [-Summary <String>] [-Description <String>] [-Reporter

<String>] [-Assignee <String>] [-Versions <String[]>] [-FixVersions <String[]>] [-Components <String[]>]

[-TimeEstimate <Nullable`1>] [-Priority <String>] [-ParentTaskKey <String>] [-Properties <Hashtable>] [-Session

<AtlassianSession>] [<CommonParameters>]



Add-JIRAIssue -ProjectKey <String> -IssueType <String> [-Summary <String>] [-Description <String>] [-Reporter

<String>] [-Assignee <String>] [-Versions <String[]>] [-FixVersions <String[]>] [-Components <String[]>]

[-TimeEstimate <Nullable`1>] [-Priority <String>] [-ParentTaskKey <String>] [-Properties <Hashtable>] [-Session

<AtlassianSession>] [<CommonParameters>]





DESCRIPTION

The Add-JIRAIssue cmdlet gets a specified JIRAIssue object or performs a search to get multiple JIRAIssue objects.





PARAMETERS

-Project <JIRAProject>

Specifies the JIRAProject in which the issue should be created.



Required? true

Position? named

Default value

Accept pipeline input? false

Accept wildcard characters? false



-ProjectKey <String>

Specifies the key of the JIRA project in which the issue should be created.



Required? true

Position? named

Default value

Accept pipeline input? false

Accept wildcard characters? false



-IssueType <String>

Specifies the name of the issue type for the new JIRA issue



Required? true

Position? named

Default value

Accept pipeline input? false

Accept wildcard characters? false



-Summary <String>

Specifies the summary for for the new JIRA issue



Required? false

Position? named

Default value

Accept pipeline input? false

Accept wildcard characters? false



-Description <String>

Specifies the description for for the new JIRA issue



Required? false

Position? named

Default value

Accept pipeline input? false

Accept wildcard characters? false



-Reporter <String>

Specifies the account name of the reporter for for the new JIRA issue



Required? false

Position? named

Default value

Accept pipeline input? false

Accept wildcard characters? false



-Assignee <String>

Specifies the account name of the assignee for for the new JIRA issue



Required? false

Position? named

Default value

Accept pipeline input? false

Accept wildcard characters? false



-Versions <String[]>

Specifies the (list of) affected version(s) for for the new JIRA issue



Required? false

Position? named

Default value

Accept pipeline input? false

Accept wildcard characters? false



-FixVersions <String[]>

Specifies the (list of) fix version(s) for for the new JIRA issue



Required? false

Position? named

Default value

Accept pipeline input? false

Accept wildcard characters? false



-Components <String[]>

Specifies the (list of) component(s) for for the new JIRA issue



Required? false

Position? named

Default value

Accept pipeline input? false

Accept wildcard characters? false



-TimeEstimate <Nullable`1>

Specifies the estimated time for for the new JIRA issue



Required? false

Position? named

Default value

Accept pipeline input? false

Accept wildcard characters? false



-Priority <String>

Specifies the name of the priority for for the new JIRA issue



Required? false

Position? named

Default value

Accept pipeline input? false

Accept wildcard characters? false



-ParentTaskKey <String>

Specifies the key of the parent task for for the new JIRA issue

This should only be specified for issuetypes that are sub-tasks



Required? false

Position? named

Default value

Accept pipeline input? false

Accept wildcard characters? false



-Properties <Hashtable>

Specifies the (list of) extra propertie(s) for for the new JIRA issue



Required? false

Position? named

Default value

Accept pipeline input? false

Accept wildcard characters? false



-Session <AtlassianSession>

Specifies the AtlassianSession to use to perform this task.

If none is specified Get-AtlassianSession is called.



Required? false

Position? named

Default value (Get-AtlassianSession)

Accept pipeline input? false

Accept wildcard characters? false



<CommonParameters>

This cmdlet supports the common parameters: Verbose, Debug,

ErrorAction, ErrorVariable, WarningAction, WarningVariable,

OutBuffer, PipelineVariable, and OutVariable. For more information, see

about_CommonParameters (https:/go.microsoft.com/fwlink/?LinkID=113216).



INPUTS

None

You cannot pipe input to this cmdlet.





OUTPUTS

JIRAIssue

Returns one or more JIRAIssue objects.





NOTES





Make sure to check what property fields are required for the issue type in the project you want to create your

issue in.

Also make sure that the fields you want to set are available on the screens that are available, the REST API

can not set properties that are not available in the create screen through the web interface.



-------------------------- EXAMPLE 1 --------------------------



PS C:\\>Add-JIRAIssue -ProjectKey 'TEST' -IssueType 'Task' -Summary 'Task Test' -Description 'My first task'



Gets all issues returned by the JQL filter 'project=TEST' for the currently loaded session.









-------------------------- EXAMPLE 2 --------------------------



PS C:\\>Add-JIRAIssue -Project $project -IssueType 'Task' -Summary 'Big Test' -Description 'Big Issue' -Assignee

'Test' -Priority 'Highest' -FixVersions 'Test Version' -Components 'Test Component' -TimeEstimate (New-TimeSpan

-Hours 1) -Properties @{labels=@('test','demo')}



Gets all issues returned by the JQL filter 'project=TEST' for the currently loaded session.









-------------------------- EXAMPLE 3 --------------------------



PS C:\\>Add-JIRAIssue -ProjectKey 'TEST' -IssueType 'Sub-task' -Summary 'Sub-Task Test' -Description 'Smaller

issue' -Reporter 'Test' -Assignee 'Test' -Priority 'Low' -Versions 'Test Version' -ParentTaskKey $createdTask.key

-Properties @{labels=@('uber')}



Gets all issues returned by the JQL filter 'project=TEST' for the currently loaded session.











RELATED LINKS