Share via

New-AzVmssIpConfig

  • 參考
模組:
Az.Compute

建立 VMSS 網路介面的IP組態。

Syntax

New-AzVmssIpConfig
   [[-Name] <String>]
   [[-Id] <String>]
   [[-SubnetId] <String>]
   [[-ApplicationGatewayBackendAddressPoolsId] <String[]>]
   [[-LoadBalancerBackendAddressPoolsId] <String[]>]
   [[-LoadBalancerInboundNatPoolsId] <String[]>]
   [-Primary]
   [-PrivateIPAddressVersion <String>]
   [-PublicIPAddressConfigurationName <String>]
   [-PublicIPAddressConfigurationIdleTimeoutInMinutes <Int32>]
   [-DnsSetting <String>]
   [-IpTag <VirtualMachineScaleSetIpTag[]>]
   [-PublicIPPrefix <String>]
   [-PublicIPAddressVersion <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

New-AzVmssIpConfig Cmdlet 會為虛擬機擴展集 （VMSS） 的網路介面建立IP組態物件。 指定此 Cmdlet 中的組態作為 Add-AzVmssNetworkInterfaceConfiguration Cmdlet 的 IPConfiguration 參數。

範例

範例 1：建立 VMSS 介面的 IP 組態物件

$IPConfiguration = New-AzVmssIPConfig -Name "ContosoVmssInterface02" -SubnetId $SubnetId

此命令會建立名為 ContosoVmssInterface02 的IP組態物件。 此命令會使用先前定義的子網標識符儲存在$SubnetId中。 命令會將組態設定儲存在 $IPConfiguration 變數中，以供稍後搭配 Add-AzVmssNetworkInterfaceConfiguration 使用。

範例 2：建立包含 NAT 集區設定的 IP 組態物件

$IPConfiguration = New-AzVmssIPConfig -Name "ContosoVmssInterface03" -LoadBalancerInboundNatPoolsId $expectedLb.InboundNatPools[0].Id -LoadBalancerBackendAddressPoolsId $expectedLb.BackendAddressPools[0].Id -SubnetId $SubnetId

此命令會建立名為 ContosoVmssInterface03 的 IP 組態對象，然後將它儲存在$IPConfiguration變數中以供日後使用。 此命令會使用先前定義的子網標識符儲存在$SubnetId中。 命令會將組態設定儲存在 $IPConfiguration 變數中，以供稍後使用。 此命令會指定LoadBalancerInboundNatPoolsId和LoadBalancerBackendAddressPoolsId 參數的值。

參數

-ApplicationGatewayBackendAddressPoolsId

指定負載平衡器後端位址池的參考陣列。 擴展集可以參考一個公用和一個內部負載平衡器的後端位址池。 多個擴展集無法使用相同的負載平衡器。

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

-Confirm

執行 Cmdlet 之前先提示您確認。

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

-DefaultProfile

用於與 azure 通訊的認證、帳戶、租用戶和訂用帳戶。

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

-DnsSetting

要套用至 publicIP 位址的 DNS 設定。 要套用至 publicIP 位址之 Dns 設定的功能變數名稱標籤。 功能變數名稱標籤和 VM 索引的串連將會是將要建立之公用 IP 位址資源的功能變數名稱標籤。

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

-Id

指定標識碼。

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

-IpTag

指定 Ip Tag 物件的陣列。

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

-LoadBalancerBackendAddressPoolsId

指定負載平衡器連入網路位址轉換 （NAT） 集區的參考陣列。 擴展集可以參考一個公用和一個內部負載平衡器的傳入NAT 集區。 多個擴展集無法使用相同的負載平衡器。

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

-LoadBalancerInboundNatPoolsId

指定負載平衡器內送NAT集區的參考陣列。 擴展集可以參考一個公用和一個內部負載平衡器的傳入NAT 集區。 多個擴展集無法使用相同的負載平衡器。

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

-Name

指定IP組態的名稱。

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

-Primary

指定網路介面有多個IP組態時的主要IP組態。

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

-PrivateIPAddressVersion

指定私人IP位址的IP組態。 預設值會視為 IPv4。 可能的值為：'IPv4' 和 'IPv6'。

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

-PublicIPAddressConfigurationIdleTimeoutInMinutes

公用IP位址的閒置逾時。

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

-PublicIPAddressConfigurationName

publicIP 位址組態名稱。

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

-PublicIPAddressVersion

指定公用IP位址的IP組態。 預設值會視為 IPv4。 可能的值為：'IPv4' 和 'IPv6'。

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

-PublicIPPrefix

公用IP前置詞的標識碼

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

-SubnetId

指定組態用來建立 VMSS 網路介面的子網標識碼。

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

-WhatIf

顯示執行 Cmdlet 後會發生的情況。 未執行 Cmdlet。

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

輸入

String

String[]

Int32

VirtualMachineScaleSetIpTag[]

輸出

VirtualMachineScaleSetIPConfiguration