scripts

New-Script.ps1

SYNOPSIS

Creates a simple boilerplate script.

SYNTAX

New-Script.ps1 [-NameNoun] <String> [-Synopsis <String>] [-Parameters <RuntimeDefinedParameterDictionary>]
 [-Inputs <String>] [-Outputs <String>] [-DynamicParam <ScriptBlock>] [-OutputType <Type>] [-Links <String[]>]
 [-Example <String[]>] [-Begin <ScriptBlock>] [-Process <ScriptBlock>] [-End <ScriptBlock>]
 [-RequiresVersion <Decimal>] [-RequiresModule <String[]>] [-ConfirmImpact <String>]
 [-DefaultParameterSetName <String>] [-HelpUri <Uri>] [-Indent <String>] [-RequiresRunAsAdmin]
 [-SupportsPaging] [-SupportsShouldProcess] [-PositionalBinding] [-ProgressAction <ActionPreference>]
 -NameVerb <String> [<CommonParameters>]

DESCRIPTION

EXAMPLES

EXAMPLE 1

New-Script.ps1 Add Xml -Synopsis 'Insert XML...' -OutputType xml

Creates a basic script.

PARAMETERS

-NameNoun

The noun part of the name of the script.

Type: String
Parameter Sets: (All)
Aliases:

Required: True
Position: 2
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Synopsis

A one-line description of the purpose of the script.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Parameters

A runtime parameter dictionary $DynamicParams created via Add-DynamicParam.ps1

Type: RuntimeDefinedParameterDictionary
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Inputs

Documentation about the datatype accepted as pipeline input by the script.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Outputs

Documentation about the datatype produced as output by the script.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-DynamicParam

The DynamicParam script block.

Type: ScriptBlock
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-OutputType

The return type of the script.

Type: Type
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

A list of script documentation references to link to (URLs and cmdlet names).

Type: String[]
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Example

A list of example commands to add to the script documentation.

Type: String[]
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Begin

The Begin script block.

Type: ScriptBlock
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Process

The Process (main) script block.

Type: ScriptBlock
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-End

The End script block.

Type: ScriptBlock
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-RequiresVersion

The minimum PowerShell version required for the script.

Type: Decimal
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: 3
Accept pipeline input: False
Accept wildcard characters: False

-RequiresModule

A module required by the script.

Type: String[]
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-ConfirmImpact

The potential risk of the script: High, Medium, or Low.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-DefaultParameterSetName

The name of the default parameter set.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-HelpUri

A URL for online help.

Type: Uri
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Indent

The indent string to use.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-RequiresRunAsAdmin

Indicates that the script must be run as an Administrator.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: RequiresAdmin, Admin

Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False

-SupportsPaging

Indicates that the script supports paged output.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False

-SupportsShouldProcess

Indicates that the script supports confirmation prompting and -WhatIf.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False

-PositionalBinding

Indicates that the script supports positional parameter binding.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False

-NameVerb

Type: String
Parameter Sets: (All)
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-ProgressAction

Type: ActionPreference
Parameter Sets: (All)
Aliases: proga

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

INPUTS

OUTPUTS

System.Void

NOTES