Freigeben über

New-AzureRmNetworkInterfaceIpConfig

  • Referenz
Modul:
AzureRM.Network

Erstellt eine IP-Konfiguration der Netzwerkschnittstelle.

Warnung

Das AzureRM PowerShell-Modul ist seit dem 29. Februar 2024 offiziell veraltet. Benutzern wird empfohlen, von AzureRM zum Az PowerShell-Modul zu migrieren, um weiterhin Support und Updates zu erhalten.

Obwohl das AzureRM-Modul möglicherweise weiterhin funktioniert, wird es nicht mehr gewartet, und es wird kein Support mehr angeboten. Die weitere Nutzung erfolgt daher nach Ermessen und Risiko des Benutzers. Weitere Informationen zum Übergang zum Az-Modul finden Sie in unseren Migrationsressourcen.

Syntax

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>]

Beschreibung

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

Beispiele

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

$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

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.

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

$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

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.

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:List<T>[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:List<T>[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:List<T>[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:List<T>[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:AzureRmContext, AzureCredential
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
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:List<T>[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:List<T>[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:List<T>[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:List<T>[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. Zulässige Werte für diesen Parameter:

  • 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 Subnetzobjekt 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

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]]

Ausgaben

PSNetworkInterfaceIPConfiguration

Hinweise

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