New-AzureRmNetworkInterfaceIpConfig

  • Référence
Module:
AzureRM.Network

Crée une configuration IP d’interface réseau.

Avertissement

Le module AzureRM PowerShell a été officiellement déprécié le 29 février 2024. Les utilisateurs sont invités à migrer d’AzureRM vers le module Az PowerShell afin de s’assurer d’une prise en charge et des mises à jour continues.

Il est possible que le module AzureRM fonctionne encore, mais il ne fait plus l’objet de maintenance ni de support. L’utilisateur peut continuer à s’en servir s’il le souhaite, à ses propres risques. Consultez nos ressources sur la migration pour obtenir des conseils sur la transition vers le module Az.

Syntaxe

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

Description

L’applet de commande New-AzureRmNetworkInterfaceIpConfig crée une configuration IP d’interface réseau Azure pour une interface réseau.

Exemples

1 : Créer une configuration IP avec une adresse IP publique pour une interface réseau

$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

Les deux premières commandes obtiennent un réseau virtuel appelé myvnet et un sous-réseau appelé mysubnet respectivement qui ont été créés précédemment. Ils sont stockés dans $vnet et $Subnet respectivement. La troisième commande obtient une adresse IP publique créée précédemment appelée PIP1. La commande suivante crée une configuration IP appelée « IPConfig-1 » comme configuration IP principale avec une adresse IP publique associée. La dernière commande crée ensuite une interface réseau appelée mynic1 à l’aide de cette configuration IP.

2 : Créer une configuration IP avec une adresse IP privée

$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

Les deux premières commandes obtiennent un réseau virtuel appelé myvnet et un sous-réseau appelé mysubnet respectivement qui ont été créés précédemment. Ils sont stockés dans $vnet et $Subnet respectivement. La troisième commande crée une configuration IP appelée « IPConfig-2 » avec une adresse IP privée 10.0.0.5 associée. La dernière commande crée ensuite une interface réseau appelée mynic1 à l’aide de cette configuration IP.

Paramètres

-ApplicationGatewayBackendAddressPool

Spécifie une collection de références de pool d’adresses principales application gateway auxquelles appartient cette configuration IP de l’interface réseau.

Type:List<T>[PSApplicationGatewayBackendAddressPool]
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-ApplicationGatewayBackendAddressPoolId

Spécifie une collection de références de pool d’adresses principales application gateway auxquelles appartient cette configuration IP de l’interface réseau.

Type:List<T>[String]
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-ApplicationSecurityGroup

Spécifie une collection de références de groupe de sécurité d’application auxquelles appartient cette configuration IP de l’interface réseau.

Type:List<T>[PSApplicationSecurityGroup]
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-ApplicationSecurityGroupId

Spécifie une collection de références de groupe de sécurité d’application auxquelles appartient cette configuration IP de l’interface réseau.

Type:List<T>[String]
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-DefaultProfile

Informations d’identification, compte, locataire et abonnement utilisés pour la communication avec Azure.

Type:IAzureContextContainer
Alias:AzureRmContext, AzureCredential
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-LoadBalancerBackendAddressPool

Spécifie une collection de références de pool d’adresses principales de l’équilibreur de charge auxquelles appartient cette configuration IP de l’interface réseau.

Type:List<T>[PSBackendAddressPool]
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-LoadBalancerBackendAddressPoolId

Spécifie une collection de références de pool d’adresses principales de l’équilibreur de charge auxquelles appartient cette configuration IP de l’interface réseau.

Type:List<T>[String]
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-LoadBalancerInboundNatRule

Spécifie une collection de références de règle nat entrante de l’équilibreur de charge auquel appartient cette interface réseau IPConfiguration.

Type:List<T>[PSInboundNatRule]
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-LoadBalancerInboundNatRuleId

Spécifie une collection de références de règle NAT (Load Balancer inbound Network Address Translation) auxquelles appartient cette configuration IP de l’interface réseau.

Type:List<T>[String]
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-Name

Spécifie le nom de la configuration IP de l’interface réseau.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Primary

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-PrivateIpAddress

Spécifie l’adresse IP statique de la configuration IP de l’interface réseau.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-PrivateIpAddressVersion

Spécifie la version d’adresse IP d’une configuration IP d’interface réseau. Les valeurs valides pour ce paramètre sont :

  • IPv4
  • IPv6
Type:String
Valeurs acceptées:IPv4, IPv6
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-PublicIpAddress

Spécifie un objet PublicIPAddress . Cette applet de commande crée une référence à une adresse IP publique à associer à cette configuration IP de l’interface réseau.

Type:PSPublicIpAddress
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-PublicIpAddressId

Cette applet de commande crée une référence à une adresse IP publique à associer à cette configuration IP de l’interface réseau.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Subnet

Spécifie un objet Subnet . Cette applet de commande crée une référence à un sous-réseau dans lequel cette configuration IP de l’interface réseau est créée.

Type:PSSubnet
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-SubnetId

Spécifie une référence à un sous-réseau dans lequel cette configuration IP de l’interface réseau est créée.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

Entrées

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

Sorties

PSNetworkInterfaceIPConfiguration

Notes

  • Mots clés : azure, azurerm, arm, resource, management, manager, network, networking