New-AzureRmNetworkInterface

Référence

Module:: AzureRM.Network

Crée une interface réseau.

Avertissement

Le module AzureRM PowerShell a été officiellement déconseillé depuis 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.

Bien que le module AzureRM puisse toujours fonctionner, il n’est plus conservé ou pris en charge, plaçant toute utilisation continue à la discrétion et au risque de l’utilisateur. Consultez nos ressources sur la migration pour obtenir des conseils sur la transition vers le module Az.

Syntaxe

New-AzureRmNetworkInterface
   -Name <String>
   -ResourceGroupName <String>
   -Location <String>
   -IpConfiguration <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSNetworkInterfaceIPConfiguration]>
   [-DnsServer <System.Collections.Generic.List`1[System.String]>]
   [-InternalDnsNameLabel <String>]
   [-EnableIPForwarding]
   [-EnableAcceleratedNetworking]
   [-Tag <Hashtable>]
   [-Force]
   [-AsJob]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzureRmNetworkInterface
   -Name <String>
   -ResourceGroupName <String>
   -Location <String>
   -IpConfiguration <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSNetworkInterfaceIPConfiguration]>
   [-NetworkSecurityGroupId <String>]
   [-NetworkSecurityGroup <PSNetworkSecurityGroup>]
   [-DnsServer <System.Collections.Generic.List`1[System.String]>]
   [-InternalDnsNameLabel <String>]
   [-EnableIPForwarding]
   [-EnableAcceleratedNetworking]
   [-Tag <Hashtable>]
   [-Force]
   [-AsJob]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzureRmNetworkInterface
   -Name <String>
   -ResourceGroupName <String>
   -Location <String>
   -SubnetId <String>
   [-PublicIpAddressId <String>]
   [-NetworkSecurityGroupId <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]>]
   [-PrivateIpAddress <String>]
   [-IpConfigurationName <String>]
   [-DnsServer <System.Collections.Generic.List`1[System.String]>]
   [-InternalDnsNameLabel <String>]
   [-EnableIPForwarding]
   [-EnableAcceleratedNetworking]
   [-Tag <Hashtable>]
   [-Force]
   [-AsJob]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzureRmNetworkInterface
   -Name <String>
   -ResourceGroupName <String>
   -Location <String>
   -Subnet <PSSubnet>
   [-PublicIpAddress <PSPublicIpAddress>]
   [-NetworkSecurityGroup <PSNetworkSecurityGroup>]
   [-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]>]
   [-PrivateIpAddress <String>]
   [-IpConfigurationName <String>]
   [-DnsServer <System.Collections.Generic.List`1[System.String]>]
   [-InternalDnsNameLabel <String>]
   [-EnableIPForwarding]
   [-EnableAcceleratedNetworking]
   [-Tag <Hashtable>]
   [-Force]
   [-AsJob]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

L’applet de commande New-AzureRmNetworkInterface crée une interface réseau Azure.

Exemples

Exemple 1 : Créer une interface réseau Azure

PS C:\>New-AzureRmNetworkInterface -Name "NetworkInterface1" -ResourceGroupName "ResourceGroup1" -Location "centralus" -SubnetId "/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/ResourceGroup1/providers/Microsoft.Network/virtualNetworks/VirtualNetwork1/subnets/Subnet1" -IpConfigurationName "IPConfiguration1" -DnsServer "8.8.8.8", "8.8.4.4"

Cette commande crée une interface réseau nommée NetworkInterface001 avec une adresse IP privée affectée dynamiquement à partir de Subnet1 dans le réseau virtuel nommé VirtualNetwork1. La commande affecte également deux serveurs DNS à l’interface réseau. La ressource enfant IPConfiguration est créée automatiquement à l’aide du nom IPConfiguration1.

Exemple 2 : Créer une interface réseau Azure à l’aide d’un objet de configuration IP

PS C:\>$IPconfig = New-AzureRmNetworkInterfaceIpConfig -Name "IPConfig1" -PrivateIpAddressVersion IPv4 -PrivateIpAddress "10.0.1.10" -SubnetId "/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/ResourceGroup1/providers/Microsoft.Network/virtualNetworks/VirtualNetwork1/subnets/Subnet1"
PS C:\> New-AzureRmNetworkInterface -Name "NetworkInterface1" -ResourceGroupName "ResourceGroup1" -Location "centralus" -IpConfiguration $IPconfig

Cet exemple crée une interface réseau à l’aide d’un objet de configuration IP. L’objet de configuration IP spécifie une adresse IPv4 privée statique. La première commande crée une configuration IP d’interface réseau nommée IPConfig1 et stocke la configuration dans la variable nommée $IPconfig. La deuxième commande crée une interface réseau nommée NetworkInterface1 qui utilise la configuration IP de l’interface réseau stockée dans la variable nommée $IPconfig.

Paramètres

-ApplicationGatewayBackendAddressPool

Spécifie un objet ApplicationGatewayBackendAddressPool .

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 l’ID d’un objet ApplicationGatewayBackendAddressPool .

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 la configuration IP de l’interface réseau doit appartenir.

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 la configuration IP de l’interface réseau doit appartenir.

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

-AsJob

Exécuter l’applet de commande en arrière-plan

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

-Confirm

Vous demande une confirmation avant d’exécuter l’applet de commande.

Type:	SwitchParameter
Alias:	cf
Position:	Named
Valeur par défaut:	False
Obligatoire:	False
Accepter l'entrée de pipeline:	False
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

-DnsServer

Spécifie le serveur DNS pour 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

-EnableAcceleratedNetworking

Active la mise en réseau accélérée.

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

-EnableIPForwarding

Indique que cette applet de commande active le transfert IP pour l’interface réseau. Le transfert IP permet à une machine virtuelle de recevoir le trafic adressé à d’autres destinations.

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

-Force

Force la création de l’interface réseau même si une interface réseau portant le même nom existe déjà.

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

-InternalDnsNameLabel

Spécifie l’étiquette de nom DNS interne pour la nouvelle interface réseau.

Type:	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

-IpConfiguration

Spécifie la configuration IP utilisée par cette applet de commande pour l’interface réseau.

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

-IpConfigurationName

Spécifie le nom d’une configuration IP.

Type:	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

-LoadBalancerBackendAddressPool

Spécifie un objet BackendAddressPool .

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 l’ID d’un objet BackendAddressPool .

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 configuration de règle NAT de trafic entrant pour un équilibreur de charge.

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 l’ID d’une configuration de règle NAT entrante pour un équilibreur de charge.

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

-Location

Spécifie la région d’une interface réseau.

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

-Name

Spécifie le nom de l’interface réseau à créer.

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

-NetworkSecurityGroup

Spécifie un objet NetworkSecurityGroup .

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

-NetworkSecurityGroupId

Spécifie l’ID d’un groupe de sécurité réseau.

Type:	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

-PrivateIpAddress

Spécifie une adresse IP IPv4 statique à affecter à cette interface réseau.

Type:	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

-PublicIpAddress

Spécifie un objet PublicIPAddress à affecter à une interface réseau.

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

-PublicIpAddressId

Spécifie l’ID d’un objet PublicIPAddress à affecter à une interface réseau.

Type:	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

-ResourceGroupName

Spécifie le nom d’un groupe de ressources auquel appartient l’interface réseau.

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

-Subnet

Spécifie un objet Subnet . Cette applet de commande crée une interface réseau pour le sous-réseau spécifié par ce paramètre.

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

-SubnetId

Spécifie l’ID du sous-réseau pour lequel créer une interface réseau.

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

-Tag

Paires clé-valeur sous la forme d’une table de hachage. Par exemple : @{key0="value0 » ; key1=$null ; key2="value2"}

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

-WhatIf

Montre ce qui se passe en cas d’exécution de l’applet de commande. L’applet de commande n’est pas exécutée.

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

Entrées

String

List<T>[[Microsoft.Azure.Commands.Network.Models.PSNetworkInterfaceIPConfiguration, Microsoft.Azure.Commands.Network, Version=6.4.1.0, Culture=neutral, PublicKeyToken=null]]

PSSubnet

PSPublicIpAddress

PSNetworkSecurityGroup

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

Hashtable

Sorties

PSNetworkInterface

Partager via