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.

Syntax

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
Accept pipeline input:	True
Accept wildcard characters:	False

-ApplicationGatewayBackendAddressPoolId

Spécifie l’ID d’un objet ApplicationGatewayBackendAddressPool .

Type:	List<T>[String]
Position:	Named
valeur par défaut:	None
Obligatoire:	False
Accept pipeline input:	True
Accept wildcard characters:	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
Accept pipeline input:	True
Accept wildcard characters:	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
Accept pipeline input:	True
Accept wildcard characters:	False

-AsJob

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

Type:	SwitchParameter
Position:	Named
valeur par défaut:	None
Obligatoire:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

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

Type:	SwitchParameter
Aliases:	cf
Position:	Named
valeur par défaut:	False
Obligatoire:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DefaultProfile

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

Type:	IAzureContextContainer
Aliases:	AzureRmContext, AzureCredential
Position:	Named
valeur par défaut:	None
Obligatoire:	False
Accept pipeline input:	False
Accept wildcard characters:	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
Accept pipeline input:	True
Accept wildcard characters:	False

-EnableAcceleratedNetworking

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

Type:	SwitchParameter
Position:	Named
valeur par défaut:	None
Obligatoire:	False
Accept pipeline input:	False
Accept wildcard characters:	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
Accept pipeline input:	False
Accept wildcard characters:	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
Accept pipeline input:	False
Accept wildcard characters:	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
Accept pipeline input:	True
Accept wildcard characters:	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
Accept pipeline input:	True
Accept wildcard characters:	False

-IpConfigurationName

Spécifie le nom d’une configuration IP.

Type:	String
Position:	Named
valeur par défaut:	None
Obligatoire:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-LoadBalancerBackendAddressPool

Spécifie un objet BackendAddressPool .

Type:	List<T>[PSBackendAddressPool]
Position:	Named
valeur par défaut:	None
Obligatoire:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-LoadBalancerBackendAddressPoolId

Spécifie l’ID d’un objet BackendAddressPool .

Type:	List<T>[String]
Position:	Named
valeur par défaut:	None
Obligatoire:	False
Accept pipeline input:	True
Accept wildcard characters:	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
Accept pipeline input:	True
Accept wildcard characters:	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
Accept pipeline input:	True
Accept wildcard characters:	False

-Location

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

Type:	String
Position:	Named
valeur par défaut:	None
Obligatoire:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Name

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

Type:	String
Aliases:	ResourceName
Position:	Named
valeur par défaut:	None
Obligatoire:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-NetworkSecurityGroup

Spécifie un objet NetworkSecurityGroup .

Type:	PSNetworkSecurityGroup
Position:	Named
valeur par défaut:	None
Obligatoire:	False
Accept pipeline input:	True
Accept wildcard characters:	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
Accept pipeline input:	True
Accept wildcard characters:	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
Accept pipeline input:	True
Accept wildcard characters:	False

-PublicIpAddress

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

Type:	PSPublicIpAddress
Position:	Named
valeur par défaut:	None
Obligatoire:	False
Accept pipeline input:	True
Accept wildcard characters:	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
Accept pipeline input:	True
Accept wildcard characters:	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
Accept pipeline input:	True
Accept wildcard characters:	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
Accept pipeline input:	True
Accept wildcard characters:	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
Accept pipeline input:	True
Accept wildcard characters:	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
Accept pipeline input:	True
Accept wildcard characters:	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
Aliases:	wi
Position:	Named
valeur par défaut:	False
Obligatoire:	False
Accept pipeline input:	False
Accept wildcard characters:	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