Set-AzureServiceProjectRole

  • Article

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

Set-AzureServiceProjectRole

Sets the number of instances or the runtime version of a role.

Parameter Set: Instances
Set-AzureServiceProjectRole [[-RoleName] <String> ] [-Instances] <Int32> [[-PassThru]] [ <CommonParameters>]

Parameter Set: Runtime
Set-AzureServiceProjectRole [[-RoleName] <String> ] [-Runtime] <String> [-Version] <String> [[-PassThru]] [ <CommonParameters>]

Parameter Set: VMSize
Set-AzureServiceProjectRole [[-RoleName] <String> ] [[-PassThru]] -VMSize <String> [ <CommonParameters>]

The Set-AzureServiceProjectRole cmdlet sets the number of role instances for the specified role.

-Instances<Int32>

Specifies the number of role instances for the specified web or worker role.

Aliases

none

Required?

true

Position?

2

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-PassThru

Aliases

none

Required?

false

Position?

4

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-RoleName<String>

Specifies the name of the web or worker role to be changed.

Aliases

none

Required?

false

Position?

1

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-Runtime<String>

Specifies the runtime to add to the specified role.

Aliases

none

Required?

true

Position?

2

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-Version<String>

Specifies the version of the runtime to add to the role.

Aliases

none

Required?

true

Position?

3

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-VMSize<String>

Aliases

none

Required?

true

Position?

named

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.

  • Specifies the size of the virtual machine.

Outputs

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

Set instances for a web role

Sets the number of instances for the web role named 'MyWebRole1' to 2.

PS C:\> Set-AzureServiceProjectRole “MyWebRole” 2

Set instances for a worker role

Sets the role instance count for the worker role named WorkerRole1 to 2.

PS C:\> Set-AzureServiceProjectRole “MyWorkerRole1” 2

Set the runtime version for a role service

Sets the node.exe runtime version for role “MyRole1” to 0.6.20.

PS C:\> Set-AzureServiceProjectRole “MyRole1” node 0.6.20

Set-AzureServiceProject