Set-AzureRmNetworkInterface

  • Référence
Module:
AzureRM.Network

Définit l’état d’objectif d’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

Set-AzureRmNetworkInterface
   -NetworkInterface <PSNetworkInterface>
   [-AsJob]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Description

Set-AzureRmNetworkInterface définit l’état d’objectif d’une interface réseau Azure.

Exemples

Exemple 1 : Configurer une interface réseau

$Nic = Get-AzureRmNetworkInterface -ResourceGroupName "ResourceGroup1" -Name "NetworkInterface1"
$Nic.IpConfigurations[0].PrivateIpAddress = "10.0.1.20"
$Nic.IpConfigurations[0].PrivateIpAllocationMethod = "Static"
$Nic.Tag = @{Name = "Name"; Value = "Value"}
Set-AzureRmNetworkInterface -NetworkInterface $Nic

Cet exemple configure une interface réseau. La première commande obtient une interface réseau nommée NetworkInterface1 dans le groupe de ressources ResourceGroup1. La deuxième commande définit l’adresse IP privée de la configuration IP. La troisième commande définit la méthode d’allocation IP privée sur Static. La quatrième commande définit une balise sur l’interface réseau. La cinquième commande utilise les informations stockées dans la variable $Nic pour définir l’interface réseau.

Exemple 2 : Modifier les paramètres DNS sur une interface réseau

$nic = Get-AzureRmNetworkInterface -ResourceGroupName "ResourceGroup1" -Name "NetworkInterface1"
$nic.DnsSettings.DnsServers.Add("192.168.1.100")
$nic | Set-AzureRmNetworkInterface

La première commande obtient une interface réseau nommée NetworkInterface1 qui existe dans le groupe de ressources ResourceGroup1. La deuxième commande ajoute le serveur DNS 192.168.1.100 à cette interface. La troisième commande applique ces modifications à l’interface réseau. Pour supprimer un serveur DNS, suivez les commandes répertoriées ci-dessus, mais remplacez ». Ajouter " avec « . Supprimez » dans la deuxième commande.

Exemple 3 : Activer le forwading IP sur une interface réseau

$nic = Get-AzureRmNetworkInterface -ResourceGroupName "ResourceGroup1" -Name "NetworkInterface1"
$nic.EnableIPForwarding = 1
$nic | Set-AzureRmNetworkInterface

La première commande obtient une interface réseau existante appelée NetworkInterface1 et la stocke dans la variable $nic. La deuxième commande modifie la valeur de transfert IP sur true. Enfin, la troisième commande applique les modifications apportées à l’interface réseau. Pour désactiver le transfert IP sur une interface réseau, suivez l’exemple, mais veillez à remplacer la deuxième commande par « $nic ». EnableIPForwarding = 0 ».

Exemple 4 : Modifier le sous-réseau d’une interface réseau

$nic = Get-AzureRmNetworkInterface -ResourceGroupName "ResourceGroup1" -Name "NetworkInterface1"
$vnet = Get-AzureRmVirtualNetwork -Name VNet1 -ResourceGroupName crosssubcrossversionpeering
$subnet2 = Get-AzureRmVirtualNetworkSubnetConfig -Name Subnet2 -VirtualNetwork $vnet
$nic.IpConfigurations[0].Subnet.Id = $subnet2.Id
$nic | Set-AzureRmNetworkInterface

La première commande obtient l’interface réseau NetworkInterface1 et la stocke dans la variable $nic. La deuxième commande obtient le réseau virtuel associé au sous-réseau auquel l’interface réseau va être associée. La deuxième commande obtient le sous-réseau et le stocke dans la variable $subnet 2. La troisième commande a associé l’adresse IP privée principale de l’interface réseau au nouveau sous-réseau. Enfin, la dernière commande a appliqué ces modifications sur l’interface réseau.

Remarque

Les configurations IP doivent être dynamiques avant de pouvoir modifier le sous-réseau. Si vous avez des configurations IP statiques, passez à dynamique avant de continuer.

Remarque

Si l’interface réseau a plusieurs configurations IP, la commande suivante doit être effectuée pour toutes ces configurations IP avant l’exécution de la commande Set-AzureRmNetworkInterface finale. Cette opération peut être effectuée comme dans la commande suivante, mais en remplaçant « 0 » par le nombre approprié. Si une interface réseau a des configurations IP N, n-1 de ces commandes doit exister.

Exemple 5 : Associer/dissocier un groupe de sécurité réseau à une interface réseau

$nic = Get-AzureRmNetworkInterface -ResourceGroupName "ResourceGroup1" -Name "NetworkInterface1"
$nsg = Get-AzureRmNetworkSecurityGroup -ResourceGroupName "ResourceGroup1" -Name "MyNSG"
$nic.NetworkSecurityGroup = $nsg
$nic | Set-AzureRmNetworkInterface

La première commande obtient une interface réseau existante appelée NetworkInterface1 et la stocke dans la variable $nic. La deuxième commande obtient un groupe de sécurité réseau existant appelé MyNSG et le stocke dans la variable $nsg. La commande suivante affecte le $nsg au $nic. Enfin, la cinquième commande applique les modifications apportées à l’interface réseau. Pour dissocier les groupes de sécurité réseau d’une interface réseau, remplacez simplement $nsg dans la commande de sortie par $null.

Paramètres

-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

-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

-NetworkInterface

Spécifie un objet NetworkInterface qui représente l’état d’objectif d’une interface réseau.

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

Entrées

PSNetworkInterface

Paramètres : NetworkInterface (ByValue)

Sorties

PSNetworkInterface