Add-AzServiceFabricNodeType

Add a new node type to the existing cluster.

Syntax

Add-AzServiceFabricNodeType
   [-ResourceGroupName] <String>
   [-Name] <String>
   -Capacity <Int32>
   -VmUserName <String>
   -VmPassword <SecureString>
   [-VmSku <String>]
   [-Tier <String>]
   [-DurabilityLevel <DurabilityLevel>]
   [-IsPrimaryNodeType <Boolean>]
   [-VMImagePublisher <String>]
   [-VMImageOffer <String>]
   [-VMImageSku <String>]
   [-VMImageVersion <String>]
   -NodeType <String>
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Add a new node type to a existing cluster.

Examples

Example 1

$pwd = ConvertTo-SecureString -String 'Password$123456' -AsPlainText -Force
Add-AzServiceFabricNodeType -ResourceGroupName 'Group1' -Name 'Contoso01SFCluster' -NodeType 'n2' -Capacity 5 -VmUserName 'adminName' -VmPassword $pwd

This command will add a new NodeType 'n2' with capacity of 5, and the vm admin name is 'adminName'.

Example 2

New node type will be a primary node type and will copy the VM image reference of the first discovered preexiting Node Type VMSS, substituting ImageSku with 18.04-LTS.

  • Existing node type image reference: ImagePublisher: Canonical, ImageOffer: UbuntuServer, ImageSku: 16.04-LTS, ImageVersion: latest
  • New node type image reference: ImagePublisher: Canonical, ImageOffer: UbuntuServer, ImageSku: 18.04-LTS, ImageVersion: latest
$pwd = ConvertTo-SecureString -String 'Password$123456' -AsPlainText -Force
$resourceGroup = "Group2"
$clusterName = "Contoso01SFCluster"
$nodeTypeName = "n3"
Add-AzServiceFabricNodeType -ResourceGroupName $resourceGroup -Name $clusterName -NodeType $nodeTypeName -Capacity 5 -VmUserName 'adminName' -VmPassword $pwd -DurabilityLevel Silver -Verbose -VMImageSku 18.04-LTS -IsPrimaryNodeType $true

This command will add a new NodeType 'n3' with capacity of 5, the vm admin name is 'adminName', Durability level Silver (tenant and infrastructure jobs are safely brokered using the Infrastructure Service), and VMSS is created using VM image profile publisher-offer-sku-version with sku interchanged to '18.04-LTS'.

Parameters

-Capacity

Capacity

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

-Confirm

Prompts you for confirmation before running the cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

The credentials, account, tenant, and subscription used for communication with Azure.

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DurabilityLevel

Specify the durability level of the NodeType.

Type:DurabilityLevel
Accepted values:Bronze, Silver, Gold
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-IsPrimaryNodeType

Define whether the node type is a primary node type. Primary node type may have seed nodes and system services.

Type:Nullable<T>[Boolean]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Name

Specify the name of the cluster

Type:String
Aliases:ClusterName
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-NodeType

The node type name

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

-ResourceGroupName

Specify the name of the resource group.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Tier

Vm Sku Tier

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

-VMImageOffer

Specify the VM image reference Offer.

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

-VMImagePublisher

Specify the VM image reference Publisher.

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

-VMImageSku

Specify the VM image reference Sku.

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

-VMImageVersion

Specify the VM image reference Version.

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

-VmPassword

The password for login to the Vm

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

-VmSku

The sku name

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

-VmUserName

The user name for logging to Vm

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

-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet is not run.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Inputs

String

Int32

SecureString

DurabilityLevel

System.Nullable<System.Boolean>

Outputs

PSCluster