Udostępnij przez

New-AzNetworkInterfaceIpConfig

Moduł:
Az.Network Module

Tworzy konfigurację adresu IP interfejsu sieciowego.

Składnia

SetByResource (domyślnie) 

New-AzNetworkInterfaceIpConfig
    -Name <String>
    [-PrivateIPAddressPrefixLength <Int32>]
    [-PrivateIpAddressVersion <String>]
    [-PrivateIpAddress <String>]
    [-Primary]
    [-Subnet <PSSubnet>]
    [-PublicIpAddress <PSPublicIpAddress>]
    [-LoadBalancerBackendAddressPool <PSBackendAddressPool[]>]
    [-LoadBalancerInboundNatRule <PSInboundNatRule[]>]
    [-ApplicationGatewayBackendAddressPool <PSApplicationGatewayBackendAddressPool[]>]
    [-ApplicationSecurityGroup <PSApplicationSecurityGroup[]>]
    [-GatewayLoadBalancerId <String>]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

SetByResourceId 

New-AzNetworkInterfaceIpConfig
    -Name <String>
    [-PrivateIPAddressPrefixLength <Int32>]
    [-PrivateIpAddressVersion <String>]
    [-PrivateIpAddress <String>]
    [-Primary]
    [-SubnetId <String>]
    [-PublicIpAddressId <String>]
    [-LoadBalancerBackendAddressPoolId <String[]>]
    [-LoadBalancerInboundNatRuleId <String[]>]
    [-ApplicationGatewayBackendAddressPoolId <String[]>]
    [-ApplicationSecurityGroupId <String[]>]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

Opis

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

Przykłady

Przykład 1. Tworzenie konfiguracji adresu IP z publicznym adresem IP dla interfejsu sieciowego

$vnet = Get-AzVirtualNetwork -Name myvnet -ResourceGroupName myrg
$Subnet = Get-AzVirtualNetworkSubnetConfig -Name mysubnet -VirtualNetwork $vnet
$PIP1 = Get-AzPublicIpAddress -Name "PIP1" -ResourceGroupName "RG1"

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

$nic = New-AzNetworkInterface -Name mynic1 -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.

Przykład 2. Tworzenie konfiguracji adresu IP z prywatnym adresem IP

$vnet = Get-AzVirtualNetwork -Name myvnet -ResourceGroupName myrg
$Subnet = Get-AzVirtualNetworkSubnetConfig -Name mysubnet -VirtualNetwork $vnet

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

$nic = New-AzNetworkInterface -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.

Przykład 3

Tworzy konfigurację adresu IP interfejsu sieciowego. (autogenerated)

New-AzNetworkInterfaceIpConfig -Name 'IP-Config2' -PrivateIpAddress '10.0.1.10' -PrivateIpAddressVersion IPv4 -SubnetId <String>

Parametry

-ApplicationGatewayBackendAddressPool

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

Właściwości parametru

Typ:

PSApplicationGatewayBackendAddressPool[]

Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

SetByResource
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:True
Wartość z pozostałych argumentów:False

-ApplicationGatewayBackendAddressPoolId

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

Właściwości parametru

Typ:

String[]

Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

SetByResourceId
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:True
Wartość z pozostałych argumentów:False

-ApplicationSecurityGroup

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

Właściwości parametru

Typ:

PSApplicationSecurityGroup[]

Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

SetByResource
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:True
Wartość z pozostałych argumentów:False

-ApplicationSecurityGroupId

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

Właściwości parametru

Typ:

String[]

Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

SetByResourceId
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:True
Wartość z pozostałych argumentów:False

-DefaultProfile

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

Właściwości parametru

Typ:IAzureContextContainer
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False
Aliasy:AzContext, AzureRmContext, AzureCredential

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-GatewayLoadBalancerId

Odwołanie do zasobu dostawcy modułu równoważenia obciążenia bramy.

Właściwości parametru

Typ:String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

SetByResource
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:True
Wartość z pozostałych argumentów: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.

Właściwości parametru

Typ:

PSBackendAddressPool[]

Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

SetByResource
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:True
Wartość z pozostałych argumentów: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.

Właściwości parametru

Typ:

String[]

Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

SetByResourceId
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:True
Wartość z pozostałych argumentów: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.

Właściwości parametru

Typ:

PSInboundNatRule[]

Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

SetByResource
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:True
Wartość z pozostałych argumentów: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.

Właściwości parametru

Typ:

String[]

Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

SetByResourceId
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:True
Wartość z pozostałych argumentów:False

-Name

Określa nazwę konfiguracji adresu IP interfejsu sieciowego.

Właściwości parametru

Typ:String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:True
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-Primary

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

Właściwości parametru

Typ:SwitchParameter
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-PrivateIpAddress

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

Właściwości parametru

Typ:String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-PrivateIPAddressPrefixLength

Określa długość prefiksu statycznego adresu IP konfiguracji adresu IP interfejsu sieciowego.

Właściwości parametru

Typ:

Nullable<T>[Int32]

Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-PrivateIpAddressVersion

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

  • IPv4
  • IPv6

Właściwości parametru

Typ:String
Domyślna wartość:None
Dopuszczalne wartości:IPv4, IPv6
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów: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.

Właściwości parametru

Typ:PSPublicIpAddress
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

SetByResource
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-PublicIpAddressId

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

Właściwości parametru

Typ:String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

SetByResourceId
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-Subnet

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

Właściwości parametru

Typ:PSSubnet
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

SetByResource
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-SubnetId

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

Właściwości parametru

Typ:String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

SetByResourceId
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

CommonParameters

To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.

Dane wejściowe

String

PSBackendAddressPool

PSInboundNatRule

PSApplicationGatewayBackendAddressPool

PSApplicationSecurityGroup

Dane wyjściowe

PSNetworkInterfaceIPConfiguration

Uwagi

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