Ecosyste.ms: Awesome

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

Awesome Lists | Featured Topics | Projects

https://github.com/celerium/myitprocess-powershellwrapper

PowerShell wrapper for the MyITProcess API
https://github.com/celerium/myitprocess-powershellwrapper

api kaseya myitprocess powershell rest rest-api

Last synced: about 1 month ago
JSON representation

PowerShell wrapper for the MyITProcess API

Awesome Lists containing this project

README

        




_CeleriumDemo


Celerium_MyITProcessAPI


[![Az_Pipeline][Az_Pipeline-shield]][Az_Pipeline-url]
[![GitHub_Pages][GitHub_Pages-shield]][GitHub_Pages-url]

[![PoshGallery_Version][PoshGallery_Version-shield]][PoshGallery_Version-url]
[![PoshGallery_Platforms][PoshGallery_Platforms-shield]][PoshGallery_Platforms-url]
[![PoshGallery_Downloads][PoshGallery_Downloads-shield]][PoshGallery_Downloads-url]
[![codeSize][codeSize-shield]][codeSize-url]

[![Contributors][contributors-shield]][contributors-url]
[![Forks][forks-shield]][forks-url]
[![Stargazers][stars-shield]][stars-url]
[![Issues][issues-shield]][issues-url]

[![Blog][Website-shield]][Website-url]
[![GitHub_License][GitHub_License-shield]][GitHub_License-url]

---

## Buy me a coffee

Whether you use this project, have learned something from it, or just like it, please consider supporting it by buying me a coffee, so I can dedicate more time on open-source projects like this :)

Buy Me A Coffee

---





Logo


PowerShell Gallery
·
Report Bug
·
Request Feature


---

## About The Project

The [MyITProcessAPI](https://www.trumethods.com/myitprocess) offers users the ability to extract data from MyITProcess into third-party reporting tools and aims to abstract away the details of interacting with MyITProcess's API endpoints in such a way that is consistent with PowerShell nomenclature. This gives system administrators and PowerShell developers a convenient and familiar way of using MyITProcess's API to create documentation scripts, automation, and integrations.

- :book: Project documentation can be found on [Github Pages](https://celerium.github.io/MyITProcess-PowerShellWrapper/)
- :book: MyITProcess's [REST API documentation here](https://reporting.live.myitprocess.com/index.html).

MyITProcess features a REST API that makes use of common HTTPs GET actions. In order to maintain PowerShell best practices, only approved verbs are used.

- GET -> Get-

Additionally, PowerShell's `verb-noun` nomenclature is respected. Each noun is prefixed with `MyITProcess` in an attempt to prevent naming problems.

For example, one might access the `/clients` endpoint by running the following PowerShell command with the appropriate parameters:

```posh
Get-MyITProcessClients
```

(back to top)

## Install

This module can be installed directly from the [PowerShell Gallery](https://www.powershellgallery.com/packages/MyITProcessAPI) with the following command:

```posh
Install-Module -Name MyITProcessAPI
```

- :information_source: This module supports PowerShell 5.0+ and *should* work in PowerShell Core.
- :information_source: If you are running an older version of PowerShell, or if PowerShellGet is unavailable, you can manually download the *main* branch and place the *MyITProcessAPI* folder into the (default) `C:\Program Files\WindowsPowerShell\Modules` folder.

Project documentation can be found on [Github Pages](https://celerium.github.io/MyITProcess-PowerShellWrapper/)

- A full list of functions can be retrieved by running `Get-Command -Module MyITProcessAPI`.
- Help info and a list of parameters can be found by running `Get-Help `, such as:

```posh
Get-Help Get-MyITProcessClients
Get-Help Get-MyITProcessClients -Full
```

(back to top)

## Initial Setup

After installing this module, you will need to configure both the *base URI* & *API key* that are used to talk with the MyITProcess API.

1. Run `Add-MyITProcessBaseURI`
- By default, MyITProcess's `https://reporting.live.myitprocess.com/public-api/v1` URI is used.
- If you have your own API gateway or proxy, you may put in your own custom URI by specifying the `-base_uri` parameter:
- `Add-MyITProcessBaseURI -base_uri http://myapi.gateway.celerium.org`

2. Run `Add-MyITProcessAPIKey -Api_Key 123456789`
- It will prompt you to enter your API key if you do not specify them.
- MyITProcess API key are generated via the [MyITProcess portal](https://helpdesk.kaseya.com/hc/en-gb/articles/4438175877521-myITprocess-API)

3. [**optional**] Run `Export-MyITProcessModuleSettings`
- This will create a config file at `%UserProfile%\MyITProcessAPI` that holds the *base uri* & *API key* information.
- Next time you run `Import-Module -Name MyITProcessAPI`, this configuration file will automatically be loaded.
- :warning: Exporting module settings encrypts your API key in a format that can **only be unencrypted by the user principal** that encrypted the secret. It makes use of .NET DPAPI, which for Windows uses reversible encrypted tied to your user principal. This means that you **cannot copy** your configuration file to another computer or user account and expect it to work.
- :warning: However in Linux\Unix operating systems the secret keys are more obfuscated than encrypted so it is recommend to use a more secure & cross-platform storage method.

(back to top)

## Usage

Calling an API resource is as simple as running `Get-MyITProcess`

- The following is a table of supported functions and their corresponding API resources:

|Category |EndpointUri |Method|Function |
|---------------|--------------------------------------------------|------|--------------------------------|
|clients |/clients |GET |Get-MyITProcessClients |
|findings |/findings |GET |Get-MyITProcessFindings |
|initiatives |/initiatives |GET |Get-MyITProcessInitiatives |
|meetings |/meetings |GET |Get-MyITProcessMeetings |
|recommendations|/recommendations |GET |Get-MyITProcessRecommendations |
|recommendations|/recommendations/{recommendationId}/configurations|GET |Get-MyITProcessRecommendations |
|reviews |/reviews |GET |Get-MyITProcessReviews |
|reviews |/reviews/categories/overdue |GET |Get-MyITProcessReviews |
|users |/users |GET |Get-MyITProcessUsers |

Each `Get-MyITProcess*` function will respond with the raw data that MyITProcess's API provides.

- :warning: Returned data is mostly structured the same but can vary between commands.
- `page` - The current page number
- `pageSize` - The amount of data per page number
- `totalCount` - The total number of objects found
- `items` - The actual information that was requested

(back to top)

## Roadmap

- [ ] Add Changelog
- [ ] Add example scripts & automation

See the [open issues](https://github.com/Celerium/MyITProcess-PowerShellWrapper/issues) for a full list of proposed features (and known issues).

(back to top)

---

## Contributing

Contributions are what makes the open-source community such an amazing place to learn, inspire, and create. Any contributions you make are **greatly appreciated**.

If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement".
Don't forget to give the project a star! Thanks again!

See the [CONTRIBUTING](https://github.com/Celerium/MyITProcess-PowerShellWrapper/blob/main/.github/CONTRIBUTING.md) guide for more information about contributing.

(back to top)

## License

Distributed under the MIT License. See [`LICENSE`](https://github.com/Celerium/MyITProcess-PowerShellWrapper/blob/main/LICENSE) for more information.

[![GitHub_License][GitHub_License-shield]][GitHub_License-url]

(back to top)

## Contact


·
Website
·
Email
·
Reddit
·


(back to top)

## Acknowledgments

Big thank you to the following people and services as they have provided me with lots of helpful information as I continue this project!

- [GitHub Pages](https://pages.github.com)
- [Img Shields](https://shields.io)
- [Font Awesome](https://fontawesome.com)
- [Choose an Open Source License](https://choosealicense.com)
- [GitHub Emoji Cheat Sheet](https://www.webpagefx.com/tools/emoji-cheat-sheet)

(back to top)

[Az_Pipeline-shield]: https://img.shields.io/azure-devops/build/AzCelerium/MyITProcessAPI/7?style=for-the-badge&label=DevOps_Build
[Az_Pipeline-url]: https://dev.azure.com/AzCelerium/MyITProcessAPI/_build?definitionId=7

[GitHub_Pages-shield]: https://img.shields.io/github/actions/workflow/status/celerium/MyITProcess-PowerShellWrapper/pages%2Fpages-build-deployment?style=for-the-badge&label=GitHub%20Pages
[GitHub_Pages-url]: https://github.com/Celerium/MyITProcess-PowerShellWrapper/actions/workflows/pages/pages-build-deployment

[GitHub_License-shield]: https://img.shields.io/github/license/celerium/MyITProcess-PowerShellWrapper?style=for-the-badge
[GitHub_License-url]: https://github.com/Celerium/MyITProcess-PowerShellWrapper/blob/main/LICENSE

[PoshGallery_Version-shield]: https://img.shields.io/powershellgallery/v/MyITProcessapi?include_prereleases&style=for-the-badge
[PoshGallery_Version-url]: https://www.powershellgallery.com/packages/MyITProcessAPI

[PoshGallery_Platforms-shield]: https://img.shields.io/powershellgallery/p/MyITProcessapi?style=for-the-badge
[PoshGallery_Platforms-url]: https://www.powershellgallery.com/packages/MyITProcessAPI

[PoshGallery_Downloads-shield]: https://img.shields.io/powershellgallery/dt/MyITProcessAPI?style=for-the-badge
[PoshGallery_Downloads-url]: https://www.powershellgallery.com/packages/MyITProcessAPI

[website-shield]: https://img.shields.io/website?up_color=blue&url=https%3A%2F%2Fcelerium.org&style=for-the-badge&label=Blog
[website-url]: https://celerium.org

[codeSize-shield]: https://img.shields.io/github/repo-size/celerium/MyITProcess-PowerShellWrapper?style=for-the-badge
[codeSize-url]: https://github.com/Celerium/MyITProcess-PowerShellWrapper

[contributors-shield]: https://img.shields.io/github/contributors/celerium/MyITProcess-PowerShellWrapper?style=for-the-badge
[contributors-url]: https://github.com/Celerium/MyITProcess-PowerShellWrapper/graphs/contributors

[forks-shield]: https://img.shields.io/github/forks/celerium/MyITProcess-PowerShellWrapper?style=for-the-badge
[forks-url]: https://github.com/Celerium/MyITProcess-PowerShellWrapper/network/members

[stars-shield]: https://img.shields.io/github/stars/celerium/MyITProcess-PowerShellWrapper?style=for-the-badge
[stars-url]: https://github.com/Celerium/MyITProcess-PowerShellWrapper/stargazers

[issues-shield]: https://img.shields.io/github/issues/Celerium/MyITProcess-PowerShellWrapper?style=for-the-badge
[issues-url]: https://github.com/Celerium/MyITProcess-PowerShellWrapper/issues