Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/atlassianps/jiraps

PowerShell module to interact with Atlassian JIRA
https://github.com/atlassianps/jiraps

api atlassian atlassianps jira powershell powershell-gallery rest windows-powershell

Last synced: 25 days ago
JSON representation

PowerShell module to interact with Atlassian JIRA

Awesome Lists containing this project

README

        

---
layout: module
permalink: /module/JiraPS/
---
# [JiraPS](https://atlassianps.org/module/JiraPS)

[![GitHub release](https://img.shields.io/github/release/AtlassianPS/JiraPS.svg?style=for-the-badge)](https://github.com/AtlassianPS/JiraPS/releases/latest)
[![Build Status](https://img.shields.io/github/actions/workflow/status/AtlassianPS/JiraPS/build_and_test.yml?style=for-the-badge)](https://github.com/AtlassianPS/JiraPS/actions/workflows/build_and_test.yml)
[![PowerShell Gallery](https://img.shields.io/powershellgallery/dt/JiraPS.svg?style=for-the-badge)](https://www.powershellgallery.com/packages/JiraPS)
![License](https://img.shields.io/badge/license-MIT-blue.svg?style=for-the-badge)

JiraPS is a Windows PowerShell module to interact with Atlassian [JIRA] via a REST API, while maintaining a consistent PowerShell look and feel.

Join the conversation on [![SlackLogo][] AtlassianPS.Slack.com](https://atlassianps.org/slack)

[SlackLogo]: https://atlassianps.org/assets/img/Slack_Mark_Web_28x28.png

---

## Instructions

### Installation

Install JiraPS from the [PowerShell Gallery]! `Install-Module` requires PowerShellGet (included in PS v5, or download for v3/v4 via the gallery link)

```powershell
# One time only install:
Install-Module JiraPS -Scope CurrentUser

# Check for updates occasionally:
Update-Module JiraPS
```

### Usage

```powershell
# To use each session:
Import-Module JiraPS
Set-JiraConfigServer 'https://YourCloud.atlassian.net'
New-JiraSession -Credential $cred
```

You can find the full documentation on our [homepage](https://atlassianps.org/docs/JiraPS) and in the console.

```powershell
# Review the help at any time!
Get-Help about_JiraPS
Get-Command -Module JiraPS
Get-Help Get-JiraIssue -Full # or any other command
```

For more information on how to use JiraPS, check out the [Documentation](https://atlassianps.org/docs/JiraPS/).

### Contribute

Want to contribute to AtlassianPS? Great!
We appreciate [everyone](https://atlassianps.org/#people) who invests their time to make our modules the best they can be.

Check out our guidelines on [Contributing] to our modules and documentation.

#### DevContainer

This repository offers a ["devcontainer"](https://containers.dev/) setup.

> **What are Development Containers?**
> A development container (or dev container for short) allows you to use
> a container as a full-featured development environment.
> It can be used to run an application, to separate tools, libraries,
> or runtimes needed for working with a codebase,
> and to aid in continuous integration and testing.

You can use the devcontainer to spin up a fine tuned development environment with
everything you need for working on this project.

The easiest way for using DevContainers is with [VS Code](https://code.visualstudio.com/),
its extension `ms-vscode-remote.remote-containers`,
and [docker](https://docs.docker.com/engine/install/).
When opening the repository in VS Code, it will recommend the installation of the extension.
And once installed, you will be prompted to "Reopen in Container".

## Tested on

* Windows Powershell v3
* Windows Powershell v4
* Windows Powershell v5.1
* Powershell Core (latest) on Windows
* Powershell Core (latest) on Ubuntu
* Powershell Core (latest) on MacOS

## Acknowledgements

* Thanks to [replicaJunction] for getting this module on its feet
* Thanks to everyone ([Our Contributors](https://atlassianps.org/#people)) that helped with this module

## Useful links

* [Source Code]
* [Latest Release]
* [Submit an Issue]
* [Contributing]
* How you can help us: [List of Issues](https://github.com/AtlassianPS/JiraPS/issues?q=is%3Aissue+is%3Aopen+label%3Aup-for-grabs)

## Disclaimer

Hopefully this is obvious, but:

> This is an open source project (under the [MIT license]), and all contributors are volunteers. All commands are executed at your own risk. Please have good backups before you start, because you can delete a lot of stuff if you're not careful.

[JIRA]: https://www.atlassian.com/software/jira
[PowerShell Gallery]: https://www.powershellgallery.com/
[Source Code]: https://github.com/AtlassianPS/JiraPS
[Latest Release]: https://github.com/AtlassianPS/JiraPS/releases/latest
[Submit an Issue]: https://github.com/AtlassianPS/JiraPS/issues/new
[replicaJunction]: https://github.com/replicaJunction
[MIT license]: https://github.com/AtlassianPS/JiraPS/blob/master/LICENSE
[Contributing]: http://atlassianps.org/docs/Contributing