Add-AzVMNetworkInterfaceConfiguration
Ajoute une configuration d’interface réseau implicite à une machine virtuelle.
Syntaxe
Default (Par défaut)
Add-AzVMNetworkInterfaceConfiguration
[-VM] <PSVirtualMachine>
[-Name <String>]
[-Primary]
[-IpConfiguration <VirtualMachineNetworkInterfaceIPConfiguration[]>]
[-NetworkApiVersion <String>]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
L’applet de commande Add-AzVMNetworkInterfaceConfiguration ajoute une configuration d’interface réseau implicite à un objet de machine virtuelle configurable.
Il initialise le profil réseau si nécessaire et conserve les configurations d’interface réseau existantes.
Exemples
Exemple 1 : Ajouter une interface réseau implicite avec une balise IP de service interne
$serviceTagResourceId = '/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.Network/firstPartyServiceTags/myServiceTag'
$subnetId = '/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/myVNet/subnets/mySubnet'
$ipTag = New-AzVMIpTagConfig -IpTagType 'FirstPartyUsage' -FirstPartyServiceTagId $serviceTagResourceId
$ipConfig = New-AzVMIpConfig -Name 'ipConfig' -SubnetId $subnetId -PublicIPAddressConfigurationName 'publicIpConfig' -IpTag $ipTag
$vmConfig = New-AzVMConfig -VMName 'myVM' -VMSize 'Standard_D2s_v5'
$vmConfig = Add-AzVMNetworkInterfaceConfiguration -VM $vmConfig -Name 'nicConfig' -Primary -IpConfiguration $ipConfig -NetworkApiVersion '2022-11-01'
Cet exemple ajoute une interface réseau implicite et une configuration IP publique imbriquée à un objet de configuration de machine virtuelle.
Paramètres
-Confirm
Vous invite à confirmer avant d’exécuter l’applet de commande.
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
Alias: cf
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
-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
-IpConfiguration
Spécifie les configurations IP à ajouter à la configuration de l’interface réseau.
Propriétés du paramètre
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
-Name
Spécifie le nom de configuration de l’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
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
-NetworkApiVersion
Spécifie la Microsoft. Version de l’API réseau utilisée pour créer les ressources réseau implicites.
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
-Primary
Spécifie s’il s’agit de la configuration de l’interface réseau 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
(All)
Position: Named
Obligatoire: False
Valeur du pipeline: False
Valeur du pipeline par nom de propriété: False
Valeur des arguments restants: False
-VM
Spécifie l’objet de machine virtuelle configurable à mettre à jour.
Créez l’objet avec New-AzVMConfig .
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: VirtualMachine
Jeux de paramètres
(All)
Position: Named
Obligatoire: True
Valeur du pipeline: True
Valeur du pipeline par nom de propriété: True
Valeur des arguments restants: False
-WhatIf
Affiche ce qui se passerait si l’applet de commande s’exécute. L’applet de commande ne s’exécute pas.
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
Alias: wi
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
CommonParameters
Cette applet de commande prend en charge les paramètres communs : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters .
Sorties