Script modules vs binary modules in PowerShell

Introduction

Modules help organize and reuse code in PowerShell. Script modules and binary modules are two ways to package code for easy sharing and use.

When you want to share reusable PowerShell functions with others.

When you need to organize your scripts into a neat package.

When you want to use compiled code for better performance.

When you want to extend PowerShell with custom commands written in .NET.

When you want to quickly write and share simple scripts without compiling.

Syntax

PowerShell

Script Module: A .psm1 file containing PowerShell functions and scripts.
Binary Module: A compiled .dll file containing cmdlets written in a .NET language.

Script modules are easy to create and edit because they are plain text files.

Binary modules require compiling code but can offer faster execution and more complex features.

Examples

This is a simple script module with one function that returns a greeting.

PowerShell

# Script Module example
function Get-Greeting {
    param([string]$Name)
    "Hello, $Name!"
}

Export-ModuleMember -Function Get-Greeting

Binary modules are compiled and loaded as DLL files. You cannot see the code directly in PowerShell.

PowerShell

# Binary Module example
# This is a compiled DLL, so no direct code here.
# You load it with Import-Module MyBinaryModule.dll

Sample Program

This example shows how to create and use a simple script module that greets a person by name.

PowerShell

# Create a script module file named GreetingModule.psm1 with this content:
function Get-Greeting {
    param([string]$Name)
    "Hello, $Name!"
}

Export-ModuleMember -Function Get-Greeting

# Then in PowerShell, run:
Import-Module ./GreetingModule.psm1
Get-Greeting -Name "Friend"

Important Notes

Script modules are great for quick development and easy sharing.

Binary modules are better when you need performance or want to use .NET features.

You can use both types together in your PowerShell environment.

Summary

Script modules are plain text files with PowerShell code.

Binary modules are compiled DLLs with cmdlets written in .NET.

Choose script modules for simplicity and binary modules for performance or advanced features.