Partager via

Add-AzVMNetworkInterface

Module:
Az.Compute Module

Ajoute une interface réseau à une machine virtuelle.

Syntaxe

GetNicFromNicId (Par défaut) 

Add-AzVMNetworkInterface
    [-VM] <PSVirtualMachine>
    [-Id] <String>
    [-Primary]
    [-DeleteOption <String>]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

GetNicFromNicObject 

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

Description

L’applet de commande Add-AzVMNetworkInterface 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

$VirtualMachine = New-AzVMConfig -VMName "VirtualMachine07" -VMSize "Standard_A1"
Add-AzVMNetworkInterface -VM $VirtualMachine -Id "/subscriptions/46fc8ea4-2de6-4179-8ab1-365da4121af4/resourceGroups/contoso/providers/Microsoft.Network/networkInterfaces/sshNIC"

La première commande crée un objet de machine virtuelle, puis la stocke dans la variable $VirtualMachine. La commande affecte 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

$VirtualMachine = Get-AzVM -ResourceGroupName "ResourceGroup11" -Name "VirtualMachine07"
Add-AzVMNetworkInterface -VM $VirtualMachine -Id "/subscriptions/46fc8ea4-2de6-4179-8ab1-365da4121af4/resourceGroups/contoso/providers/Microsoft.Network/networkInterfaces/sshNIC"
Update-AzVM -ResourceGroupName "ResourceGroup11" -VM $VirtualMachine

La première commande obtient la machine virtuelle nommée VirtualMachine07 à l’aide de l’applet de commande Get-AzVM . 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.

Propriétés du paramètre

Type:IAzureContextContainer
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:AzContext, AzureRmContext, AzureCredential

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-DeleteOption

Spécifie l’option de suppression de l’interface réseau après la suppression de la machine virtuelle. Les options sont Détacher, Supprimer

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-Id

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

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:NicId, NetworkInterfaceId

Jeux de paramètres

GetNicFromNicId
Position:1
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-NetworkInterface

Spécifie l’interface réseau.

Propriétés du paramètre

Type:

List<T>[INetworkInterfaceReference]

Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

GetNicFromNicObject
Position:1
Obligatoire:True
Valeur du pipeline:True
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Primary

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

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

GetNicFromNicId
Position:2
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants: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-AzVMConfig . Pour obtenir une machine virtuelle existante, utilisez l’applet de commande Get-AzVM .

Propriétés du paramètre

Type:PSVirtualMachine
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:VMProfile

Jeux de paramètres

(All)
Position:0
Obligatoire:True
Valeur du pipeline:True
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

CommonParameters

Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.

Entrées

PSVirtualMachine

String

List<T>

SwitchParameter

Sorties

PSVirtualMachine