Set-AzureRole

Module:
Azure
Sets the number of instances of an Azure role to run.

Syntax

Set-AzureRole
   [-ServiceName] <String>
   [-Slot] <String>
   [-RoleName] <String>
   [-Count] <Int32>
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [-Profile <AzureSMProfile>]
   [<CommonParameters>]

Description

The Set-AzureRole cmdlet sets the number of instances of a specified role to run in an Azure deployment.

Examples

1: Set the number of instances for a role

PS C:\> Set-AzureRole -ServiceName "MySvc01" -Slot "Production" -RoleName "MyTestRole03" -Count 3

This command sets the MyTestRole03 role that is running in production on the MySvc01 service to have three instances.

Required Parameters

-Count

Specifies the number of role instances to run.

Type:Int32
Position:3
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-RoleName

Specifies the name of the role for which to set the number of instances.

Type:String
Position:2
Default value:None
Accept pipeline input:True (ByPropertyName)
Accept wildcard characters:False
-ServiceName

Specifies the name of the Azure service.

Type:String
Position:0
Default value:None
Accept pipeline input:True (ByPropertyName)
Accept wildcard characters:False
-Slot

Specifies the deployment environment of the deployment to modify. The acceptable values for this parameter are:

  • Production
  • Staging
Type:String
Position:1
Default value:None
Accept pipeline input:True (ByPropertyName)
Accept wildcard characters:False

Optional Parameters

-InformationAction

Specifies how this cmdlet responds to an information event.

The acceptable values for this parameter are:

  • Continue
  • Ignore
  • Inquire
  • SilentlyContinue
  • Stop
  • Suspend
Type:ActionPreference
Aliases:infa
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-InformationVariable

Specifies an information variable.

Type:String
Aliases:iv
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Profile

Specifies the Azure profile from which this cmdlet reads. If you do not specify a profile, this cmdlet reads from the local default profile.

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