Freigeben über

Add-AzNetworkInterfaceIpConfig

  • Referenz
Modul:
Az.Network

Fügt einer Netzwerkschnittstellen-IP-Konfiguration eine Netzwerkschnittstelle hinzu.

Syntax

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

Beschreibung

Das Add-AzNetworkInterfaceIpConfig-Cmdlet fügt eine IP-Konfiguration der Netzwerkschnittstelle zu einer Azure-Netzwerkschnittstelle hinzu.

Beispiele

Beispiel 1: Hinzufügen einer neuen IP-Konfiguration mit einer Anwendungssicherheitsgruppe

$subnet = New-AzVirtualNetworkSubnetConfig -Name MySubnet -AddressPrefix 10.0.1.0/24
$vnet = New-AzVirtualNetwork -Name MyVNET -ResourceGroupName MyResourceGroup -Location "West US" -AddressPrefix 10.0.0.0/16 -Subnet $subnet

$nic = New-AzNetworkInterface -Name MyNetworkInterface -ResourceGroupName MyResourceGroup -Location "West US" -Subnet $vnet.Subnets[0]

$asg = New-AzApplicationSecurityGroup -ResourceGroupName MyResourceGroup -Name MyASG -Location "West US"

$nic | Set-AzNetworkInterfaceIpConfig -Name $nic.IpConfigurations[0].Name -Subnet $vnet.Subnets[0] -ApplicationSecurityGroup $asg | Set-AzNetworkInterface

$nic | Add-AzNetworkInterfaceIpConfig -Name MyNewIpConfig -Subnet $vnet.Subnets[0] -ApplicationSecurityGroup $asg | Set-AzNetworkInterface

In diesem Beispiel erstellen wir eine neue Netzwerkschnittstelle MyNetworkInterface, die zu einem Subnetz im neuen virtuellen Netzwerk MyVNET gehört. Außerdem erstellen wir eine leere Anwendungssicherheitsgruppe MyASG, die den IP-Konfigurationen in der Netzwerkschnittstelle zugeordnet wird. Sobald beide Objekte erstellt wurden, verknüpfen wir die Standard-IP-Konfiguration mit dem MyASG-Objekt. Schließlich erstellen wir eine neue IP-Konfiguration in der Netzwerkschnittstelle, die auch mit dem Anwendungssicherheitsgruppenobjekt verknüpft ist.

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-Regeln (Load Balancer) an, zu denen diese IP-Konfiguration der Netzwerkschnittstelle gehört.

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

-LoadBalancerInboundNatRuleId

Gibt eine Auflistung eingehender NAT-Regelverweise 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

-NetworkInterface

Gibt ein NetworkInterface -Objekt an. Dieses Cmdlet fügt dem Objekt, das dieser Parameter angibt, eine IP-Konfiguration der Netzwerkschnittstelle hinzu.

Typ:PSNetworkInterface
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
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

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

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

Eingaben

PSNetworkInterface

String[]

PSBackendAddressPool[]

PSInboundNatRule[]

PSApplicationGatewayBackendAddressPool[]

PSApplicationSecurityGroup[]

Ausgaben

PSNetworkInterface

Hinweise

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