New-AzureRoleTemplate

[This topic is pre-release documentation and is subject to change in future releases. Blank topics are included as placeholders.]

New-AzureRoleTemplate

Creates web and worker role templates.

Parameter Set: WebRole
New-AzureRoleTemplate [-Web] [[-Output] <String> ] [ <CommonParameters>]

Parameter Set: WorkerRole
New-AzureRoleTemplate [-Worker] [[-Output] <String> ] [ <CommonParameters>]

This topic describes the cmdlet in the .6.19 version of the Windows Azure PowerShell module. To find out the version of the module you're using, from the Windows Azure PowerShell console, type (get-module azure).version.

The New-AzureRoleTemplate cmdlet creates web and worker role templates.

-Output<String>

Specifies the output path of generated template. <Unclear to me…is this where you want to store the template that the cmdlet creates? Seems to be based on the example.>

Aliases

none

Required?

false

Position?

2

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-Web

Specifies that you want to create a web role template.

Aliases

none

Required?

true

Position?

1

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-Worker

Specifies that you want to create a worker role template.

Aliases

none

Required?

true

Position?

1

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

<CommonParameters>

This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see  about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).

Inputs

The input type is the type of the objects that you can pipe to the cmdlet.

Outputs

The output type is the type of the objects that the cmdlet emits.

Create a web role template

This example creates a new web role template in a folder named WebRoleTemplate in the current directory.

PS C:\> New-AzureRoleTemplate -Web

Create a worker role template

This example creates a new worker role template in a folder named WebRoleTemplate in the current directory.

PS C:\> New-AzureRoleTemplate -Worker

Create a role template in a custom directory

This example creates a new web role template in directory named MyWebRoleTemplate, instead of in the current directory.

PS C:\> New-AzureRoleTemplate -Web -Output C:\MyWebRoleTemplate

Add-AzureWebRole

Add-AzureWorkerRole