There's a lot to pick up on in our first sample:
- You can make pages in Pipeworks with minimal understanding HTML
- Pipeworks makes it simple to embed rich media, like a YouTube video, in a page
- Pipeworks supports Markdown
- Pipeworks provides many tools to generate HTML
In our next example, we'll make a quick module into a software service.
# In Pipeworks, you need 3 files to make a module.
# The Script Module ( ModuleName.PSM1),
# The Module Manifest ( ModuleName.PSD1)
# The Pipeworks Manifest (ModuleName.Pipeworks.psd1)
# This will check for the module directory and create it if it doesn't exist.
$modulePath = "$home\Documents\WindowsPowerShell\Modules\SayHello"
if (-not (Test-Path $modulePath)) {
New-Item -ItemType Directory -Path $ModulePath |
Out-Null
}
# Our module will be simple. It will have one command, Show-HelloMessage.
# We'll include it inside of the .PSM1
@'
function Show-HelloMessage
{
<#
.Synopsis
Shows a hello message
.Description
Shows a personalized hello message
#>
param(
# What is your name?
[Parameter(Mandatory=$true)]
[string]
$YourName
)
"Hello $YourName"
}
'@ |
Set-Content "$modulePath\SayHello.psm1"
# The Module Manifest File is pretty simple.
# It includes a version, a description, and it refers to the .PSM1
@'
@{
ModuleVersion = '1.0'
ModuleToProcess = 'SayHello.psm1'
Description = 'Say Hello, Wave Goodbye'
}
'@ |
Set-Content "$modulePath\SayHello.psd1"
# The Pipeworks Manifest describes how the module will turn into a web service, and what it can do.
# You can create a Pipeworks Manifest by hand, or you can use the New-PipeworksManifest command
New-PipeworksManifest -Name SayHello -WebCommand @{
"Show-HelloMessage" = @{
FriendlyName = 'Say Hello'
}
} |
Set-Content "$modulePath\SayHello.Pipeworks.psd1"
# To create your web service, run the following command:
Import-Module SayHello -Force -PassThru | ConvertTo-ModuleService -Force
# You can now navigate to http://localhost/SayHello and make it greet you
Pipeworks Quickstart
