Partager via

New-AzureRmVmssIpConfig

  • Référence
Module:
AzureRM.Compute

Crée une configuration IP pour une interface réseau d’un VMSS.

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.

Syntaxe

New-AzureRmVmssIpConfig
   [[-Name] <String>]
   [[-Id] <String>]
   [[-SubnetId] <String>]
   [[-ApplicationGatewayBackendAddressPoolsId] <String[]>]
   [[-LoadBalancerBackendAddressPoolsId] <String[]>]
   [[-LoadBalancerInboundNatPoolsId] <String[]>]
   [-Primary]
   [-PrivateIPAddressVersion <String>]
   [-PublicIPAddressConfigurationName <String>]
   [-PublicIPAddressConfigurationIdleTimeoutInMinutes <Int32>]
   [-DnsSetting <String>]
   [-IpTag <VirtualMachineScaleSetIpTag[]>]
   [-PublicIPPrefix <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

L’applet de commande New-AzureRmVmssIpConfig crée un objet de configuration IP pour une interface réseau d’un groupe de machines virtuelles identiques (VMSS). Spécifiez la configuration à partir de cette applet de commande en tant que paramètre IPConfiguration de l’applet de commande Add-AzureRmVmssNetworkInterfaceConfiguration.

Exemples

Exemple 1 : Créer un objet de configuration IP pour une interface VMSS

PS C:\> $IPConfiguration = New-AzureRmVmssIPConfig -Name "ContosoVmssInterface02" -SubnetId $SubnetId

Cette commande crée un objet de configuration IP nommé ContosoVmssInterface02. La commande utilise un ID de sous-réseau précédemment défini stocké dans $SubnetId. La commande stocke les paramètres de configuration dans la variable $IPConfiguration pour une utilisation ultérieure avec Add-AzureRmVmssNetworkInterfaceConfiguration.

Exemple 2 : Créer un objet de configuration IP qui inclut les paramètres du pool NAT

PS C:\> $IPConfiguration = New-AzureRmVmssIPConfig -Name "ContosoVmssInterface03" -LoadBalancerInboundNatPoolsId $expectedLb.InboundNatPools[0].Id -LoadBalancerBackendAddressPoolsId $expectedLb.BackendAddressPools[0].Id -SubnetId $SubnetId

Cette commande crée un objet de configuration IP nommé ContosoVmssInterface03, puis le stocke dans la variable $IPConfiguration pour une utilisation ultérieure. La commande utilise un ID de sous-réseau précédemment défini stocké dans $SubnetId. La commande stocke les paramètres de configuration dans la variable $IPConfiguration pour une utilisation ultérieure. La commande spécifie les valeurs des paramètres LoadBalancerInboundNatPoolsId et LoadBalancerBackendAddressPoolsId .

Paramètres

-ApplicationGatewayBackendAddressPoolsId

Spécifie un tableau de références aux pools d’adresses back-end d’équilibreurs de charge. Un groupe identique peut référencer des pools d’adresses back-end d’un équilibreur de charge public et interne. Plusieurs groupes identiques ne peuvent pas utiliser le même équilibreur de charge.

Type:String[]
Position:3
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-Confirm

Vous demande une confirmation avant d’exécuter l’applet de commande.

Type:SwitchParameter
Alias:cf
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: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

-DnsSetting

Paramètres dns à appliquer sur les adresses publicIP. Étiquette de nom de domaine des paramètres Dns à appliquer sur les adresses PUBLICIP. La concaténation de l’étiquette de nom de domaine et de l’index de machine virtuelle sera les étiquettes de nom de domaine des ressources d’adresse IP publique qui seront créées.

Type:String
Alias:PublicIPAddressDomainNameLabel
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-Id

Spécifie un ID.

Type:String
Position:1
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-IpTag

Spécifie un tableau d’objets De balise IP.

Type:VirtualMachineScaleSetIpTag[]
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-LoadBalancerBackendAddressPoolsId

Spécifie un tableau de références aux pools de traduction d’adresses réseau entrantes (NAT) des équilibreurs de charge. Un groupe identique peut référencer des pools NAT entrants d’un équilibreur de charge public et interne. Plusieurs groupes identiques ne peuvent pas utiliser le même équilibreur de charge.

Type:String[]
Position:4
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-LoadBalancerInboundNatPoolsId

Spécifie un tableau de références aux pools NAT entrants des équilibreurs de charge. Un groupe identique peut référencer des pools NAT entrants d’un équilibreur de charge public et interne. Plusieurs groupes identiques ne peuvent pas utiliser le même équilibreur de charge.

Type:String[]
Position:5
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-Name

Spécifie le nom de la configuration IP.

Type:String
Position:0
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-Primary

Spécifie la configuration IP principale au cas où l’interface réseau possède plusieurs configurations IP.

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

-PrivateIPAddressVersion

Spécifiez la configuration ip est IPv4 ou IPv6. La valeur par défaut est prise en tant que IPv4. Les valeurs possibles sont : « IPv4 » et « IPv6 ».

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-PublicIPAddressConfigurationIdleTimeoutInMinutes

Délai d’inactivité de l’adresse IP publique.

Type:Int32
Alias:PublicIPAddressIdleTimeoutInMinutes
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-PublicIPAddressConfigurationName

Nom de configuration de l’adresse PUBLICIP.

Type:String
Alias:PublicIPAddressName
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-PublicIPPrefix

ID du préfixe d’adresse IP publique

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-SubnetId

Spécifie l’ID de sous-réseau dans lequel la configuration crée l’interface réseau VMSS.

Type:String
Position:2
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-WhatIf

Montre ce qui se passe en cas d’exécution de l’applet de commande. L’applet de commande n’est pas exécutée.

Type:SwitchParameter
Alias:wi
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

Entrées

String

String[]

Int32

VirtualMachineScaleSetIpTag[]

Sorties

VirtualMachineScaleSetIPConfiguration