New-AzureRmVmssIpConfig
建立 VMSS 網路介面的IP組態。
警告
自 2024 年 2 月 29 日起，AzureRM PowerShell 模組已正式淘汰。 建議使用者從 AzureRM 遷移至 Az PowerShell 模組，以確保持續支援和更新。
雖然 AzureRM 模組可能仍可運作，但不再維護或支援它，但會根據用戶的判斷權和風險放置任何繼續使用。 如需轉換至 Az 模組的指引，請參閱我們的 移轉資源 。
語法
New-AzureRmVmssIpConfig
[[-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>]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Description
New-AzureRmVmssIpConfig Cmdlet 會為虛擬機擴展集 （VMSS） 的網路介面建立IP組態物件。 指定此 Cmdlet 中的組態作為 Add-AzureRmVmssNetworkInterfaceConfiguration Cmdlet 的 IPConfiguration 參數。
範例
範例 1：建立 VMSS 介面的 IP 組態物件
PS C:\> $IPConfiguration = New-AzureRmVmssIPConfig -Name "ContosoVmssInterface02" -SubnetId $SubnetId此命令會建立名為 ContosoVmssInterface02 的IP組態物件。 此命令會使用先前定義的子網標識符儲存在$SubnetId中。 命令會將組態設定儲存在 $IPConfiguration 變數中，以供稍後搭配 Add-AzureRmVmssNetworkInterfaceConfiguration 使用。
範例 2：建立包含 NAT 集區設定的 IP 組態物件
PS C:\> $IPConfiguration = New-AzureRmVmssIPConfig -Name "ContosoVmssInterface03" -LoadBalancerInboundNatPoolsId $expectedLb.InboundNatPools[0].Id -LoadBalancerBackendAddressPoolsId $expectedLb.BackendAddressPools[0].Id -SubnetId $SubnetId此命令會建立名為 ContosoVmssInterface03 的 IP 組態對象，然後將它儲存在$IPConfiguration變數中以供日後使用。 此命令會使用先前定義的子網標識符儲存在$SubnetId中。 命令會將組態設定儲存在 $IPConfiguration 變數中，以供稍後使用。 此命令會指定LoadBalancerInboundNatPoolsId和LoadBalancerBackendAddressPoolsId 參數的值。
參數
-ApplicationGatewayBackendAddressPoolsId
指定負載平衡器後端位址池的參考陣列。 擴展集可以參考一個公用和一個內部負載平衡器的後端位址池。 多個擴展集無法使用相同的負載平衡器。
| 類型: | String[] |
| Position: | 3 |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-Confirm
執行 Cmdlet 之前先提示您確認。
| 類型: | SwitchParameter |
| 別名: | cf |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-DefaultProfile
用於與 azure 通訊的認證、帳戶、租用戶和訂用帳戶。
| 類型: | IAzureContextContainer |
| 別名: | AzureRmContext, AzureCredential |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-DnsSetting
要套用至 publicIP 位址的 DNS 設定。 要套用至 publicIP 位址之 Dns 設定的功能變數名稱標籤。 功能變數名稱標籤和 VM 索引的串連將會是將要建立之公用 IP 位址資源的功能變數名稱標籤。
| 類型: | String |
| 別名: | PublicIPAddressDomainNameLabel |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-Id
指定標識碼。
| 類型: | String |
| Position: | 1 |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-IpTag
指定 Ip Tag 物件的陣列。
| 類型: | VirtualMachineScaleSetIpTag[] |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-LoadBalancerBackendAddressPoolsId
指定負載平衡器連入網路位址轉換 （NAT） 集區的參考陣列。 擴展集可以參考一個公用和一個內部負載平衡器的傳入NAT 集區。 多個擴展集無法使用相同的負載平衡器。
| 類型: | String[] |
| Position: | 4 |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-LoadBalancerInboundNatPoolsId
指定負載平衡器內送NAT集區的參考陣列。 擴展集可以參考一個公用和一個內部負載平衡器的傳入NAT 集區。 多個擴展集無法使用相同的負載平衡器。
| 類型: | String[] |
| Position: | 5 |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-Name
指定IP組態的名稱。
| 類型: | String |
| Position: | 0 |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-Primary
指定網路介面有多個IP組態時的主要IP組態。
| 類型: | SwitchParameter |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-PrivateIPAddressVersion
指定IP組態為IPv4或IPv6。 預設值會視為 IPv4。 可能的值為：'IPv4' 和 'IPv6'。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-PublicIPAddressConfigurationIdleTimeoutInMinutes
公用IP位址的閒置逾時。
| 類型: | Int32 |
| 別名: | PublicIPAddressIdleTimeoutInMinutes |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-PublicIPAddressConfigurationName
publicIP 位址組態名稱。
| 類型: | String |
| 別名: | PublicIPAddressName |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-PublicIPPrefix
公用IP前置詞的標識碼
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-SubnetId
指定組態用來建立 VMSS 網路介面的子網標識碼。
| 類型: | String |
| Position: | 2 |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-WhatIf
顯示執行 Cmdlet 後會發生的情況。 未執行 Cmdlet。
| 類型: | SwitchParameter |
| 別名: | wi |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
輸入
String[]
輸出
VirtualMachineScaleSetIPConfiguration