Set-AzNetworkInterface

  • Référence
Module:
Az.Network

Met à jour une interface réseau.

Syntaxe

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

Description

Set-AzNetworkInterface met à jour une interface réseau.

Exemples

Exemple 1 : Configurer une interface réseau

$Nic = Get-AzNetworkInterface -ResourceGroupName "ResourceGroup1" -Name "NetworkInterface1"
$Nic.IpConfigurations[0].PrivateIpAddress = "10.0.1.20"
$Nic.IpConfigurations[0].PrivateIpAllocationMethod = "Static"
$Nic.Tag = @{Name = "Name"; Value = "Value"}
Set-AzNetworkInterface -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-AzNetworkInterface -ResourceGroupName "ResourceGroup1" -Name "NetworkInterface1"
$nic.DnsSettings.DnsServers.Add("192.168.1.100")
$nic | Set-AzNetworkInterface

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 transfert IP sur une interface réseau

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

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-AzNetworkInterface -ResourceGroupName "ResourceGroup1" -Name "NetworkInterface1"
$vnet = Get-AzVirtualNetwork -Name VNet1 -ResourceGroupName crosssubcrossversionpeering
$subnet2 = Get-AzVirtualNetworkSubnetConfig -Name Subnet2 -VirtualNetwork $vnet
$nic.IpConfigurations[0].Subnet.Id = $subnet2.Id
$nic | Set-AzNetworkInterface

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 quatrième commande doit être effectuée pour toutes ces configurations IP avant l’exécution de la commande Set-AzNetworkInterface finale. Cela peut être effectué comme dans la quatrième commande, 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-AzNetworkInterface -ResourceGroupName "ResourceGroup1" -Name "NetworkInterface1"
$nsg = Get-AzNetworkSecurityGroup -ResourceGroupName "ResourceGroup1" -Name "MyNSG"
$nic.NetworkSecurityGroup = $nsg
$nic | Set-AzNetworkInterface

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 troisième commande affecte la $nsg au $nic. Enfin, la quatriè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 troisième commande 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:AzContext, 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 d’interface réseau représentant l’état auquel l’interface réseau doit être définie.

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

Sorties

PSNetworkInterface