Freigeben über

New-AzNetworkInterfaceIpConfig

  • Referenz
Modul:
Az.Network

Erstellt eine IP-Konfiguration der Netzwerkschnittstelle.

Syntax

New-AzNetworkInterfaceIpConfig
   -Name <String>
   [-PrivateIpAddressVersion <String>]
   [-PrivateIpAddress <String>]
   [-Primary]
   [-Subnet <PSSubnet>]
   [-PublicIpAddress <PSPublicIpAddress>]
   [-LoadBalancerBackendAddressPool <PSBackendAddressPool[]>]
   [-LoadBalancerInboundNatRule <PSInboundNatRule[]>]
   [-ApplicationGatewayBackendAddressPool <PSApplicationGatewayBackendAddressPool[]>]
   [-ApplicationSecurityGroup <PSApplicationSecurityGroup[]>]
   [-GatewayLoadBalancerId <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
New-AzNetworkInterfaceIpConfig
   -Name <String>
   [-PrivateIpAddressVersion <String>]
   [-PrivateIpAddress <String>]
   [-Primary]
   [-SubnetId <String>]
   [-PublicIpAddressId <String>]
   [-LoadBalancerBackendAddressPoolId <String[]>]
   [-LoadBalancerInboundNatRuleId <String[]>]
   [-ApplicationGatewayBackendAddressPoolId <String[]>]
   [-ApplicationSecurityGroupId <String[]>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Beschreibung

Das Cmdlet New-AzNetworkInterfaceIpConfig erstellt eine IP-Konfiguration der Azure-Netzwerkschnittstelle für eine Netzwerkschnittstelle.

Beispiele

Beispiel 1: Erstellen einer IP-Konfiguration mit einer öffentlichen IP-Adresse für eine Netzwerkschnittstelle

$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

Die ersten beiden Befehle erhalten ein virtuelles Netzwerk namens "myvnet" und ein Subnetz mit dem Namen "mysubnet", bzw. ein Subnetz, das zuvor erstellt wurde. Diese werden jeweils in $vnet und $Subnet gespeichert. Der dritte Befehl erhält eine zuvor erstellte öffentliche IP-Adresse namens PIP1. Der vierte Befehl erstellt eine neue IP-Konfiguration namens "IPConfig-1" als primäre IP-Konfiguration mit einer öffentlichen IP-Adresse, die ihr zugeordnet ist. Der letzte Befehl erstellt dann eine Netzwerkschnittstelle namens mynic1 mithilfe dieser IP-Konfiguration.

Beispiel 2: Erstellen einer IP-Konfiguration mit einer privaten IP-Adresse

$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

Die ersten beiden Befehle erhalten ein virtuelles Netzwerk namens "myvnet" und ein Subnetz mit dem Namen "mysubnet", bzw. ein Subnetz, das zuvor erstellt wurde. Diese werden jeweils in $vnet und $Subnet gespeichert. Der dritte Befehl erstellt eine neue IP-Konfiguration namens "IPConfig-2" mit einer privaten IP-Adresse 10.0.0.5, die damit verknüpft ist. Der letzte Befehl erstellt dann eine Netzwerkschnittstelle namens mynic1 mithilfe dieser IP-Konfiguration.

Beispiel 3

Erstellt eine IP-Konfiguration der Netzwerkschnittstelle. (automatisch generiert)

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

Parameter

-ApplicationGatewayBackendAddressPool

Gibt eine Auflistung von Verweisen auf den Back-End-Adresspool des Anwendungsgateways an, zu denen diese IP-Konfiguration der Netzwerkschnittstelle gehört.

Typ:PSApplicationGatewayBackendAddressPool[]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-ApplicationGatewayBackendAddressPoolId

Gibt eine Auflistung von Verweisen auf den Back-End-Adresspool des Anwendungsgateways an, zu denen diese IP-Konfiguration der Netzwerkschnittstelle gehört.

Typ:String[]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-ApplicationSecurityGroup

Gibt eine Auflistung von Anwendungssicherheitsgruppenverweisen an, zu denen diese IP-Konfiguration der Netzwerkschnittstelle gehört.

Typ:PSApplicationSecurityGroup[]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-ApplicationSecurityGroupId

Gibt eine Auflistung von Anwendungssicherheitsgruppenverweisen an, zu denen diese IP-Konfiguration der Netzwerkschnittstelle gehört.

Typ:String[]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-DefaultProfile

Die Anmeldeinformationen, Konten, Mandanten und Abonnements, die für die Kommunikation mit Azure verwendet werden.

Typ:IAzureContextContainer
Aliase:AzContext, AzureRmContext, AzureCredential
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-GatewayLoadBalancerId

Die Referenz der Gateway LoadBalancer Provider-Ressource.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-LoadBalancerBackendAddressPool

Gibt eine Auflistung von Back-End-Adresspoolreferenzen für das Lastenausgleichsmodul an, zu der diese IP-Konfiguration der Netzwerkschnittstelle gehört.

Typ:PSBackendAddressPool[]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-LoadBalancerBackendAddressPoolId

Gibt eine Auflistung von Back-End-Adresspoolreferenzen für das Lastenausgleichsmodul an, zu der diese IP-Konfiguration der Netzwerkschnittstelle gehört.

Typ:String[]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-LoadBalancerInboundNatRule

Gibt eine Auflistung von Nat-Rule-Verweisen auf das Lastenausgleichsmodul an, zu der diese Netzwerkschnittstelle IPConfiguration gehört.

Typ:PSInboundNatRule[]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-LoadBalancerInboundNatRuleId

Gibt eine Auflistung von NAT-Regeln (Load Balancer) an, zu denen diese IP-Konfiguration der Netzwerkschnittstelle gehört.

Typ:String[]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Name

Gibt den Namen der IP-Konfiguration der Netzwerkschnittstelle an.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Primary

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-PrivateIpAddress

Gibt die statische IP-Adresse der IP-Konfiguration der Netzwerkschnittstelle an.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-PrivateIpAddressVersion

Gibt die IP-Adressversion einer IP-Konfiguration der Netzwerkschnittstelle an. Die zulässigen Werte für diesen Parameter sind:

  • IPv4
  • IPv6
Typ:String
Zulässige Werte:IPv4, IPv6
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-PublicIpAddress

Gibt ein PublicIPAddress -Objekt an. Dieses Cmdlet erstellt einen Verweis auf eine öffentliche IP-Adresse, die dieser IP-Konfiguration der Netzwerkschnittstelle zugeordnet werden soll.

Typ:PSPublicIpAddress
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-PublicIpAddressId

Dieses Cmdlet erstellt einen Verweis auf eine öffentliche IP-Adresse, die dieser IP-Konfiguration der Netzwerkschnittstelle zugeordnet werden soll.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Subnet

Gibt ein Subnetz--Objekt an. Dieses Cmdlet erstellt einen Verweis auf ein Subnetz, in dem diese IP-Konfiguration der Netzwerkschnittstelle erstellt wird.

Typ:PSSubnet
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-SubnetId

Gibt einen Verweis auf ein Subnetz an, in dem diese IP-Konfiguration der Netzwerkschnittstelle erstellt wird.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

String[]

PSBackendAddressPool[]

PSInboundNatRule[]

PSApplicationGatewayBackendAddressPool[]

PSApplicationSecurityGroup[]

Ausgaben

PSNetworkInterfaceIPConfiguration

Hinweise

  • Schlüsselwörter: azure, azurerm, arm, resource, management, manager, network, networking