https://github.com/gioxx/nebula.automations

Nebula.Automations provides reusable PowerShell functions for scripting, automation and cloud integration.
https://github.com/gioxx/nebula.automations

powershell powershell-module

Last synced: 6 months ago
JSON representation

Nebula.Automations provides reusable PowerShell functions for scripting, automation and cloud integration.

• Host: GitHub
• URL: https://github.com/gioxx/nebula.automations
• Owner: gioxx
• License: mit
• Created: 2025-07-29T12:26:44.000Z (7 months ago)
• Default Branch: main
• Last Pushed: 2025-07-29T12:31:33.000Z (7 months ago)
• Last Synced: 2025-07-29T15:05:04.762Z (7 months ago)
• Topics: powershell, powershell-module
• Language: PowerShell
• Homepage: https://go.gioxx.org/nebula-automations
• Size: 409 KB
• Stars: 0
• Watchers: 0
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE

Awesome Lists containing this project

README

          
# Nebula.Automations (formerly Nebula.Tools)

**Nebula.Automations** provides reusable PowerShell functions for scripting, automation and cloud integration.

![PowerShell Gallery](https://img.shields.io/powershellgallery/v/Nebula.Automations?label=PowerShell%20Gallery)

![Downloads](https://img.shields.io/powershellgallery/dt/Nebula.Automations?color=blue)

> [!NOTE]  

> **Why the name change?**  

> I want this module to remain specifically designed and developed to be an integral part of other scripts and automations that have little to do instead with everyday use tools. Nebula.Tools will return in another form, with different functions related to everyday use via PowerShell.  

> I apologize if this is confusing, I realize I could have thought of this long before!  

> The old GUID was invalidated and I removed the old versions from the GitHub releases. It's starting from scratch. I recommend you do the same with any installations on your machine!

---

## ✨ Included Functions

- `Send-Mail`  

  Send emails via SMTP with support for:

  - Attachments

  - CC / BCC

  - Custom SMTP server and port

- `CheckMGGraphConnection`  

  Connect to Microsoft Graph using application credentials:

  - Automatically handles module install

  - Authenticates with client ID/secret

  - Logs connection status

---

## 📦 Installation

Install from PowerShell Gallery:

```powershell

Install-Module -Name Nebula.Automations -Scope CurrentUser

```

---

## 🚀 Usage

Example to send an email:

```powershell

Send-Mail -SMTPServer "smtp.example.com" -From "me@example.com" -To "you@example.com" -Subject "Hello" -Body "Test message"

```

Example to connect to Microsoft Graph:

```powershell

$Graph = CheckMGGraphConnection -tenantId "" -clientId "" -clientSecret ""

```

---

## 🧽 How to clean up old module versions (optional)

When updating from previous versions, old files (such as unused `.psm1`, `.yml`, or `LICENSE` files) are not automatically deleted.  

If you want a completely clean setup, you can remove all previous versions manually:

```powershell

# Remove all installed versions of the module

Uninstall-Module -Name Nebula.Automations -AllVersions -Force

# Reinstall the latest clean version

Install-Module -Name Nebula.Automations -Scope CurrentUser -Force

```

ℹ️ This is entirely optional — PowerShell always uses the most recent version installed.

---

## 📄 License

All scripts in this repository are licensed under the [MIT License](https://opensource.org/licenses/MIT).

---

## 🔧 Development

This module is part of the [Nebula](https://github.com/gioxx?tab=repositories&q=Nebula) PowerShell tools family.

Feel free to fork, improve and submit pull requests.

---

## 📬 Feedback and Contributions

Feedback, suggestions, and pull requests are welcome!  

Feel free to [open an issue](https://github.com/gioxx/Nebula.Automations/issues) or contribute directly.