Skip to content

gioxx/Nebula.Scripts

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

42 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Nebula.Scripts

Nebula.Scripts is a collection of PowerShell scripts authored and maintained by Gioxx, designed to automate or simplify common administrative and development tasks.
These scripts are individually published on the PowerShell Gallery for easy discovery and installation.


📦 Available Scripts

Script Name Description
Convert-SVG Converts SVG files to PNG or JPG format using Inkscape (View on PowerShell Gallery PSGallery)
Download-FreeFileSync Checks for available FreeFileSync updates for Microsoft Windows and update it if available. (View on PowerShell Gallery PSGallery)
Get-IntuneApps View information about applications available on Intune (View on PowerShell Gallery PSGallery)
Remove-macOS-OldIntuneApps Manage macOS apps in Intune using Microsoft Graph, focusing on duplicates and old versions (View on PowerShell Gallery PSGallery)

More scripts will be added over time.

🗃️ Deprecated Scripts

Warning

Deprecated scripts will no longer receive updates on PowerShell Gallery.
Development will continue through functions included in the module.

Script Name Description
Get-DevicesInGroup View on PowerShell Gallery Deprecated: functionality is now available natively in Nebula.Core via Get-EntraGroupDevice (documentation).
Remove-OldPSModules View on PowerShell Gallery Deprecated: functionality is now available natively in Nebula.Tools via Remove-OldModuleVersions (documentation).

🚀 Getting Started

You can install a script directly from the PowerShell Gallery.
The example below is based on the Remove-OldPSModules script, available here:

Install-Script -Name Remove-OldPSModules -Scope CurrentUser -Force

Then run it:

Remove-OldPSModules.ps1

Make sure your Execution Policy allows script execution.


🆕 Creating a new script for PowerShell Gallery

Use New-ScriptFileInfo to generate a script with the correct metadata header required by the Gallery:

New-ScriptFileInfo `
  -Path .\MyScript.ps1 `
  -Version '1.0.0' `
  -Author 'Your Name' `
  -Description 'Describe what this script does.' `
  -LicenseUri 'https://opensource.org/licenses/MIT' `
  -ProjectUri 'hhttps://github.com/<your-repo>' `
  -Tags 'powershell', 'scripts', 'utilities'

This will create a .ps1 file pre-filled with a #PSScriptInfo header block. After that, you should manually add:

#Requires -Version 7.0

<#
.SYNOPSIS
Brief summary of what the script does.
.DESCRIPTION
More detailed explanation of its purpose and usage.
.EXAMPLE
.\MyScript.ps1
Demonstrates typical usage.
#>

📝 Make sure to avoid having both a .DESCRIPTION in #PSScriptInfo and in the help block at the same time, or you'll get a publishing error.

📦 PowerShell Gallery - Publishing Reference

Requirements

  • PowerShell 7.0 or later
  • PowerShellGet v3+ (Install-Module PowerShellGet -Force)
  • Valid NuGet API key

✅ Publishing a Script

Ensure your script includes a valid .PSScriptInfo block and comment-based help:

<#PSScriptInfo
.VERSION 1.0.0
.GUID <your-guid-here>
.AUTHOR Your Name
.LICENSEURI https://opensource.org/licenses/MIT
.PROJECTURI https://github.com/<your-repo>
.TAGS powershell scripts utilities
#>

#Requires -Version 7.0

<#
.SYNOPSIS
One-line summary.
.DESCRIPTION
Detailed explanation of what the script does.
.EXAMPLE
.\YourScript.ps1
Runs the script.
#>

Then run:

Publish-PSResource -Path .\YourScript.ps1 -Repository PSGallery -ApiKey '<your-api-key>' -Verbose

📄 License

All scripts in this repository are licensed under the MIT License.


🔧 Development

This module is part of the 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 or contribute directly.

About

A set of scripts not yet integrated into Nebula modules (and that they may never be).

Topics

Resources

License

Stars

Watchers

Forks

Sponsor this project

  •  

Contributors