Add-AzureRmNetworkInterfaceIpConfig

Referenz

Modul:: AzureRM.Network

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

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 weiterhin funktioniert, wird es nicht mehr Standard tained oder unterstützt, wobei eine fortgesetzte Verwendung nach Ermessen und Risiko des Benutzers erfolgt. Weitere Informationen zum Übergang zum Az-Modul finden Sie in unseren Migrationsressourcen.

Syntax

Add-AzureRmNetworkInterfaceIpConfig
   -Name <String>
   -NetworkInterface <PSNetworkInterface>
   [-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>]

Add-AzureRmNetworkInterfaceIpConfig
   -Name <String>
   -NetworkInterface <PSNetworkInterface>
   [-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 Add-AzureRmNetworkInterfaceIpConfig-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-AzureRmVirtualNetworkSubnetConfig -Name MySubnet -AddressPrefix 10.0.1.0/24
$vnet = New-AzureRmvirtualNetwork -Name MyVNET -ResourceGroupName MyResourceGroup -Location "West US" -AddressPrefix 10.0.0.0/16 -Subnet $subnet

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

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

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

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

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.

Type:	List<T>[PSApplicationGatewayBackendAddressPool]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-ApplicationGatewayBackendAddressPoolId

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

Type:	List<T>[String]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-ApplicationSecurityGroup

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

Type:	List<T>[PSApplicationSecurityGroup]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-ApplicationSecurityGroupId

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

Type:	List<T>[String]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-DefaultProfile

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

Type:	IAzureContextContainer
Aliases:	AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-LoadBalancerBackendAddressPool

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

Type:	List<T>[PSBackendAddressPool]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-LoadBalancerBackendAddressPoolId

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

Type:	List<T>[String]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-LoadBalancerInboundNatRule

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

Type:	List<T>[PSInboundNatRule]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-LoadBalancerInboundNatRuleId

Gibt eine Auflistung eingehender NAT-Regelverweise an, zu denen diese IP-Konfiguration der Netzwerkschnittstelle gehört.

Type:	List<T>[String]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Name

Gibt den Namen der IP-Konfiguration der Netzwerkschnittstelle an.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-NetworkInterface

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

Type:	PSNetworkInterface
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Primary

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-PrivateIpAddress

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-PrivateIpAddressVersion

Gibt die IP-Adressversion einer IP-Konfiguration der Netzwerkschnittstelle an. Zulässige Werte für diesen Parameter:

IPv4
IPv6

Type:	String
Accepted values:	IPv4, IPv6
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	PSPublicIpAddress
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-PublicIpAddressId

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Subnet

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

Type:	PSSubnet
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-SubnetId

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Eingaben

PSNetworkInterface

Parameter: NetworkInterface (ByValue)

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