New-AzVMIpConfig

Crée une configuration IP pour une interface réseau de machine virtuelle implicite.

Syntaxe

Default (Par défaut)

New-AzVMIpConfig
    [-Name <String>]
    [-SubnetId <String>]
    [-Primary]
    [-PrivateIPAddressVersion <String>]
    [-PublicIPAddressConfigurationName <String>]
    [-PublicIPAddressConfigurationIdleTimeoutInMinutes <Int32>]
    [-DnsSetting <String>]
    [-IpTag <VirtualMachineIpTag[]>]
    [-PublicIPPrefix <String>]
    [-PublicIPAddressVersion <String>]
    [-PublicIPAllocationMethod <String>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

L’applet de commande New-AzVMIpConfig crée une configuration IP pour une interface réseau de machine virtuelle implicite. Lorsque des paramètres IP publics ou des objets IpTag sont fournis, l’applet de commande initialise une configuration d’adresse IP publique imbriquée. Tous les objets d’étiquette IP fournis sont copiés dans cette configuration d’adresse IP publique.

Exemples

Exemple 1 : Créer une configuration IP 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

Cet exemple crée une configuration IP d’interface réseau implicite avec une configuration IP publique imbriquée et une balise IP de service interne.

Exemple 2 : Configurer les propriétés d’adresse IP privée et publique implicites

$prefixId = '/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.Network/publicIPPrefixes/myPrefix'
$ipConfig = New-AzVMIpConfig -Name 'ipConfig' -Primary -PrivateIPAddressVersion 'IPv4' `
    -PublicIPAddressConfigurationName 'publicIpConfig' -PublicIPAddressConfigurationIdleTimeoutInMinutes 10 `
    -DnsSetting 'my-vm' -PublicIPPrefix $prefixId -PublicIPAddressVersion 'IPv4' `
    -PublicIPAllocationMethod 'Static'

Cet exemple configure la version d’adresse IP privée et l’étiquette DNS, le préfixe, la version, la méthode d’allocation et le délai d’inactivité pour une adresse IP publique implicite.

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

-DnsSetting

Spécifie l’étiquette de nom de domaine pour l’adresse IP publique implicite.

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:PublicIPAddressDomainNameLabel

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

-IpTag

Spécifie les balises IP à associer à l’adresse IP publique implicite.

Propriétés du paramètre

Type:

VirtualMachineIpTag[]

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

-Name

Spécifie le nom de configuration IP.

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

Indique qu’il s’agit de la configuration IP 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

-PrivateIPAddressVersion

Spécifie la version de l’adresse IP privée. Les valeurs acceptées sont IPv4 et IPv6.

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

-PublicIPAddressConfigurationIdleTimeoutInMinutes

Spécifie le délai d’inactivité, en minutes, pour l’adresse IP publique implicite.

Propriétés du paramètre

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

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

-PublicIPAddressConfigurationName

Spécifie le nom de la configuration d’adresse IP publique implicite imbriquée.

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:PublicIPAddressName

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

-PublicIPAddressVersion

Spécifie la version de l’adresse IP publique. Les valeurs acceptées sont IPv4 et IPv6.

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

-PublicIPAllocationMethod

Spécifie la méthode d’allocation pour l’adresse IP publique implicite. Les valeurs acceptées sont dynamiques et statiques.

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

-PublicIPPrefix

Spécifie l’ID de ressource du préfixe d’adresse IP publique à partir duquel l’adresse IP publique implicite est allouée.

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

-SubnetId

Spécifie l’ID de ressource du sous-réseau pour la configuration IP.

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

-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.

Entrées

String

VirtualMachineIpTag

Sorties

VirtualMachineNetworkInterfaceIPConfiguration