Add-AzureRmVmssNetworkInterfaceConfiguration

Reference

Module:: AzureRM.Compute

Adds a network interface configuration to the VMSS.

Warning

The AzureRM PowerShell module has been officially deprecated as of February 29, 2024. Users are advised to migrate from AzureRM to the Az PowerShell module to ensure continued support and updates.

Although the AzureRM module may still function, it's no longer maintained or supported, placing any continued use at the user's discretion and risk. Please refer to our migration resources for guidance on transitioning to the Az module.

Syntax

Add-AzureRmVmssNetworkInterfaceConfiguration
   [-VirtualMachineScaleSet] <PSVirtualMachineScaleSet>
   [[-Name] <String>]
   [[-Primary] <Boolean>]
   [[-Id] <String>]
   [[-IpConfiguration] <VirtualMachineScaleSetIPConfiguration[]>]
   [-EnableAcceleratedNetworking]
   [-EnableIPForwarding]
   [-NetworkSecurityGroupId <String>]
   [-DnsSettingsDnsServer <String[]>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

The Add-AzureRmVmssNetworkInterfaceConfiguration cmdlet adds a network interface configuration to the Virtual Machine Scale Set (VMSS).

Examples

Example 1: Add a network interface configuration to the VMSS

PS C:\> Add-AzureRmVmssNetworkInterfaceConfiguration -VirtualMachineScaleSet $VMSS -Name "Test" -Primary $True -IPConfiguration $IPCfg

This command adds a network interface configuration to the VMSS.

Parameters

-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:	AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DnsSettingsDnsServer

List of dns server IP addresses for dns settings.

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

-EnableAcceleratedNetworking

Specifies whether the network interface is accelerated networking-enabled.

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

-EnableIPForwarding

Specifies whether IP forwarding enabled on this NIC.

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

-Id

Specifies the Resource ID of the virtual machine.

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

-IpConfiguration

Specifies the IP configurations of the network interface.

Type:	VirtualMachineScaleSetIPConfiguration[]
Position:	4
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Name

Specifies the name of the network interface configuration.

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

-NetworkSecurityGroupId

Id of the network security group.

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

-Primary

Indicates whether network interfaces created from the network interface configuration will be the primary network information center (NIC) of the virtual machine.