Partager via

Add-AzureRmVMNetworkInterface

  • Référence
Module:
AzureRM.Compute

Ajoute une interface réseau à une machine virtuelle.

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

Add-AzureRmVMNetworkInterface
   [-VM] <PSVirtualMachine>
   [-Id] <String>
   [-Primary]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Add-AzureRmVMNetworkInterface
   [-VM] <PSVirtualMachine>
   [-NetworkInterface] <System.Collections.Generic.List`1[Microsoft.Azure.Management.Internal.Network.Common.INetworkInterfaceReference]>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Description

L’applet de commande Add-AzureRmVMNetworkInterface ajoute une interface réseau à une machine virtuelle. Vous pouvez ajouter une interface lorsque vous créez une machine virtuelle ou ajoutez-en une à une machine virtuelle existante.

Exemples

Exemple 1 : Ajouter une interface réseau à une nouvelle machine virtuelle

PS C:\> $VirtualMachine = New-AzureRmVMConfig -VMName "VirtualMachine07" -VMSize "Standard_A1"
PS C:\> Add-AzureRmVMNetworkInterface -VM $VirtualMachine -Id "/subscriptions/46fc8ea4-2de6-4179-8ab1-365da4121af4/resourceGroups/contoso/providers/Microsoft.Network/networkInterfaces/sshNIC"

La première commande crée un objet machine virtuelle avant de le stocker dans la variable $VirtualMachine. La commande attribue un nom et une taille à la machine virtuelle. La deuxième commande ajoute une interface réseau à la machine virtuelle stockée dans $VirtualMachine.

Exemple 2 : Ajouter une interface réseau à une machine virtuelle existante

PS C:\> $VirtualMachine = Get-AzureRmVM -ResourceGroupName "ResourceGroup11" -Name "VirtualMachine07"
PS C:\> Add-AzureRmVMNetworkInterface -VM $VirtualMachine -Id "/subscriptions/46fc8ea4-2de6-4179-8ab1-365da4121af4/resourceGroups/contoso/providers/Microsoft.Network/networkInterfaces/sshNIC"
PS C:\> Update-AzureRmVM -ResourceGroupName "ResourceGroup11" -VM $VirtualMachine

La première commande obtient la machine virtuelle nommée VirtualMachine07 à l’aide de l’applet de commande Get-AzureRmVM . La commande stocke la machine virtuelle dans la variable $VirtualMachine . La deuxième commande ajoute une interface réseau à la machine virtuelle stockée dans $VirtualMachine. La commande finale met à jour l’état de la machine virtuelle stockée dans $VirtualMachine dans ResourceGroup11.

Paramètres

-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

-Id

Spécifie l’ID d’une interface réseau à ajouter à une machine virtuelle. Vous pouvez utiliser l’applet de commande Get-AzureRmNetworkInterface pour obtenir une interface réseau.

Type:String
Aliases:NicId, NetworkInterfaceId
Position:1
valeur par défaut:None
Obligatoire:True
Accept pipeline input:True
Accept wildcard characters:False

-NetworkInterface

Spécifie l’interface réseau.

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

-Primary

Indique que cette applet de commande ajoute l’interface réseau comme interface principale.

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

-VM

Spécifie un objet de machine virtuelle locale auquel ajouter une interface réseau. Pour créer une machine virtuelle, utilisez l’applet de commande New-AzureRmVMConfig . Pour obtenir une machine virtuelle existante, utilisez l’applet de commande Get-AzureRmVM .

Type:PSVirtualMachine
Aliases:VMProfile
Position:0
valeur par défaut:None
Obligatoire:True
Accept pipeline input:True
Accept wildcard characters:False

Entrées

PSVirtualMachine

String

List<T>[[Microsoft.Azure.Management.Internal.Network.Common.INetworkInterfaceReference, Microsoft.Azure.Commands.Common.Network, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null]]

SwitchParameter

Sorties

PSVirtualMachine