Udostępnij za pośrednictwem

New-AzureRmNetworkInterfaceIpConfig

  • Odwołanie
Moduł:
AzureRM.Network

Tworzy konfigurację adresu IP interfejsu sieciowego.

Ostrzeżenie

Moduł AzureRM PowerShell został oficjalnie przestarzały od 29 lutego 2024 r. Zaleca się migrowanie użytkowników z modułu AzureRM do modułu Az programu PowerShell w celu zapewnienia ciągłej obsługi i aktualizacji.

Mimo że moduł AzureRM może nadal działać, nie jest już utrzymywany ani obsługiwany, umieszczając wszelkie dalsze zastosowania według uznania i ryzyka użytkownika. Zapoznaj się z naszymi zasobami migracji, aby uzyskać wskazówki dotyczące przejścia do modułu Az.

Składnia

New-AzureRmNetworkInterfaceIpConfig
   -Name <String>
   [-PrivateIpAddressVersion <String>]
   [-PrivateIpAddress <String>]
   [-Primary]
   [-Subnet <PSSubnet>]
   [-PublicIpAddress <PSPublicIpAddress>]
   [-LoadBalancerBackendAddressPool <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSBackendAddressPool]>]
   [-LoadBalancerInboundNatRule <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSInboundNatRule]>]
   [-ApplicationGatewayBackendAddressPool <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSApplicationGatewayBackendAddressPool]>]
   [-ApplicationSecurityGroup <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSApplicationSecurityGroup]>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
New-AzureRmNetworkInterfaceIpConfig
   -Name <String>
   [-PrivateIpAddressVersion <String>]
   [-PrivateIpAddress <String>]
   [-Primary]
   [-SubnetId <String>]
   [-PublicIpAddressId <String>]
   [-LoadBalancerBackendAddressPoolId <System.Collections.Generic.List`1[System.String]>]
   [-LoadBalancerInboundNatRuleId <System.Collections.Generic.List`1[System.String]>]
   [-ApplicationGatewayBackendAddressPoolId <System.Collections.Generic.List`1[System.String]>]
   [-ApplicationSecurityGroupId <System.Collections.Generic.List`1[System.String]>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Opis

Polecenie cmdlet New-AzureRmNetworkInterfaceIpConfig tworzy konfigurację adresu IP interfejsu sieciowego platformy Azure dla interfejsu sieciowego.

Przykłady

1: Tworzenie konfiguracji adresu IP z publicznym adresem IP dla interfejsu sieciowego

$vnet = Get-AzureRmVirtualNetwork -Name myvnet -ResourceGroupName myrg
$Subnet = Get-AzureRmVirtualNetworkSubnetConfig -Name mysubnet -VirtualNetwork $vnet
$PIP1 = Get-AzureRmPublicIPAddress -Name "PIP1" -ResourceGroupName "RG1"

$IPConfig1 = New-AzureRmNetworkInterfaceIpConfig -Name "IPConfig-1" -Subnet $Subnet -PublicIpAddress $PIP1
    -Primary

 $nic = New-AzureRmNetworkInterface -Name $NicName -ResourceGroupName myrg -Location westus
    -IpConfiguration $IpConfig1

Dwa pierwsze polecenia pobierają sieć wirtualną o nazwie myvnet i podsieć o nazwie mysubnet, które zostały wcześniej utworzone. Są one przechowywane odpowiednio w $vnet i $Subnet. Trzecie polecenie pobiera wcześniej utworzony publiczny adres IP o nazwie PIP1. Polecenie forth tworzy nową konfigurację adresu IP o nazwie "IPConfig-1" jako podstawową konfigurację adresu IP z publicznym adresem IP skojarzonym z nim. Ostatnie polecenie następnie tworzy interfejs sieciowy o nazwie mynic1 przy użyciu tej konfiguracji adresu IP.

2: Tworzenie konfiguracji adresu IP z prywatnym adresem IP

$vnet = Get-AzureRmVirtualNetwork -Name myvnet -ResourceGroupName myrg
$Subnet = Get-AzureRmVirtualNetworkSubnetConfig -Name mysubnet -VirtualNetwork $vnet

$IPConfig2 = New-AzureRmNetworkInterfaceIpConfig -Name "IP-Config2" -Subnet $Subnet -PrivateIpAddress
    10.0.0.5

$nic = New-AzureRmNetworkInterface -Name mynic1 -ResourceGroupName myrg -Location westus -IpConfiguration
    $IpConfig2

Dwa pierwsze polecenia pobierają sieć wirtualną o nazwie myvnet i podsieć o nazwie mysubnet, które zostały wcześniej utworzone. Są one przechowywane odpowiednio w $vnet i $Subnet. Trzecie polecenie tworzy nową konfigurację adresu IP o nazwie "IPConfig-2" z prywatnym adresem IP 10.0.0.5 skojarzonym z nim. Ostatnie polecenie następnie tworzy interfejs sieciowy o nazwie mynic1 przy użyciu tej konfiguracji adresu IP.

Parametry

-ApplicationGatewayBackendAddressPool

Określa kolekcję puli adresów zaplecza bramy aplikacji, do której należy ta konfiguracja adresu IP interfejsu sieciowego.

Typ:List<T>[PSApplicationGatewayBackendAddressPool]
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-ApplicationGatewayBackendAddressPoolId

Określa kolekcję puli adresów zaplecza bramy aplikacji, do której należy ta konfiguracja adresu IP interfejsu sieciowego.

Typ:List<T>[String]
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-ApplicationSecurityGroup

Określa kolekcję odwołań do grupy zabezpieczeń aplikacji, do której należy ta konfiguracja adresu IP interfejsu sieciowego.

Typ:List<T>[PSApplicationSecurityGroup]
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-ApplicationSecurityGroupId

Określa kolekcję odwołań do grupy zabezpieczeń aplikacji, do której należy ta konfiguracja adresu IP interfejsu sieciowego.

Typ:List<T>[String]
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-DefaultProfile

Poświadczenia, konto, dzierżawa i subskrypcja używane do komunikacji z platformą Azure.

Typ:IAzureContextContainer
Aliasy:AzureRmContext, AzureCredential
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-LoadBalancerBackendAddressPool

Określa kolekcję puli adresów zaplecza modułu równoważenia obciążenia, do której należy ta konfiguracja adresu IP interfejsu sieciowego.

Typ:List<T>[PSBackendAddressPool]
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-LoadBalancerBackendAddressPoolId

Określa kolekcję puli adresów zaplecza modułu równoważenia obciążenia, do której należy ta konfiguracja adresu IP interfejsu sieciowego.

Typ:List<T>[String]
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-LoadBalancerInboundNatRule

Określa kolekcję odwołań reguły nat dla ruchu przychodzącego modułu równoważenia obciążenia, do których należy ten interfejs sieciowy IPConfiguration.

Typ:List<T>[PSInboundNatRule]
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-LoadBalancerInboundNatRuleId

Określa kolekcję reguł translatora adresów sieciowych (NAT) dla ruchu przychodzącego modułu równoważenia obciążenia, do których należy ta konfiguracja adresu IP interfejsu sieciowego.

Typ:List<T>[String]
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-Name

Określa nazwę konfiguracji adresu IP interfejsu sieciowego.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Primary

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-PrivateIpAddress

Określa statyczny adres IP konfiguracji adresu IP interfejsu sieciowego.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-PrivateIpAddressVersion

Określa wersję adresu IP konfiguracji adresu IP interfejsu sieciowego. Dopuszczalne wartości tego parametru to:

  • Protokół IPv4
  • Protokół IPv6
Typ:String
Dopuszczalne wartości:IPv4, IPv6
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-PublicIpAddress

Określa obiekt PublicIPAddress . To polecenie cmdlet tworzy odwołanie do publicznego adresu IP w celu skojarzenia z tą konfiguracją adresu IP interfejsu sieciowego.

Typ:PSPublicIpAddress
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-PublicIpAddressId

To polecenie cmdlet tworzy odwołanie do publicznego adresu IP w celu skojarzenia z tą konfiguracją adresu IP interfejsu sieciowego.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Subnet

Określa obiekt podsieci. To polecenie cmdlet tworzy odwołanie do podsieci, w której jest tworzona konfiguracja adresu IP interfejsu sieciowego.

Typ:PSSubnet
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-SubnetId

Określa odwołanie do podsieci, w której jest tworzona konfiguracja adresu IP interfejsu sieciowego.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

Dane wejściowe

List<T>[[System.String, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]]

List<T>[[Microsoft.Azure.Commands.Network.Models.PSBackendAddressPool, Microsoft.Azure.Commands.Network, Version=6.4.1.0, Culture=neutral, PublicKeyToken=null]]

List<T>[[Microsoft.Azure.Commands.Network.Models.PSInboundNatRule, Microsoft.Azure.Commands.Network, Version=6.4.1.0, Culture=neutral, PublicKeyToken=null]]

List<T>[[Microsoft.Azure.Commands.Network.Models.PSApplicationGatewayBackendAddressPool, Microsoft.Azure.Commands.Network, Version=6.4.1.0, Culture=neutral, PublicKeyToken=null]]

List<T>[[Microsoft.Azure.Commands.Network.Models.PSApplicationSecurityGroup, Microsoft.Azure.Commands.Network, Version=6.4.1.0, Culture=neutral, PublicKeyToken=null]]

Dane wyjściowe

PSNetworkInterfaceIPConfiguration

Uwagi

  • Słowa kluczowe: azure, azurerm, arm, resource, management, manager, network, networking