Partager via

Add-AzNetworkInterfaceIpConfig

Module:
Az.Network Module

Ajoute une configuration IP d’interface réseau à une interface réseau.

Syntaxe

SetByResource (Par défaut) 

Add-AzNetworkInterfaceIpConfig
    -Name <String>
    -NetworkInterface <PSNetworkInterface>
    [-PrivateIPAddressPrefixLength <Int32>]
    [-PrivateIpAddressVersion <String>]
    [-PrivateIpAddress <String>]
    [-Primary]
    [-Subnet <PSSubnet>]
    [-PublicIpAddress <PSPublicIpAddress>]
    [-LoadBalancerBackendAddressPool <PSBackendAddressPool[]>]
    [-LoadBalancerInboundNatRule <PSInboundNatRule[]>]
    [-ApplicationGatewayBackendAddressPool <PSApplicationGatewayBackendAddressPool[]>]
    [-ApplicationSecurityGroup <PSApplicationSecurityGroup[]>]
    [-GatewayLoadBalancerId <String>]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

SetByResourceId 

Add-AzNetworkInterfaceIpConfig
    -Name <String>
    -NetworkInterface <PSNetworkInterface>
    [-PrivateIPAddressPrefixLength <Int32>]
    [-PrivateIpAddressVersion <String>]
    [-PrivateIpAddress <String>]
    [-Primary]
    [-SubnetId <String>]
    [-PublicIpAddressId <String>]
    [-LoadBalancerBackendAddressPoolId <String[]>]
    [-LoadBalancerInboundNatRuleId <String[]>]
    [-ApplicationGatewayBackendAddressPoolId <String[]>]
    [-ApplicationSecurityGroupId <String[]>]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

Description

L’applet de commande Add-AzNetworkInterfaceIpConfig ajoute une configuration IP d’interface réseau à une interface réseau Azure.

Exemples

Exemple 1 : Ajouter une nouvelle configuration IP avec un groupe de sécurité d’application

$subnet = New-AzVirtualNetworkSubnetConfig -Name MySubnet -AddressPrefix 10.0.1.0/24
$vnet = New-AzVirtualNetwork -Name MyVNET -ResourceGroupName MyResourceGroup -Location "West US" -AddressPrefix 10.0.0.0/16 -Subnet $subnet

$nic = New-AzNetworkInterface -Name MyNetworkInterface -ResourceGroupName MyResourceGroup -Location "West US" -Subnet $vnet.Subnets[0]

$asg = New-AzApplicationSecurityGroup -ResourceGroupName MyResourceGroup -Name MyASG -Location "West US"

$nic | Set-AzNetworkInterfaceIpConfig -Name $nic.IpConfigurations[0].Name -Subnet $vnet.Subnets[0] -ApplicationSecurityGroup $asg | Set-AzNetworkInterface

$nic | Add-AzNetworkInterfaceIpConfig -Name MyNewIpConfig -Subnet $vnet.Subnets[0] -ApplicationSecurityGroup $asg | Set-AzNetworkInterface

Dans cet exemple, nous créons une interface réseau MyNetworkInterface qui appartient à un sous-réseau dans le nouveau réseau virtuel MyVNET. Nous créons également un groupe de sécurité d’application vide MyASG à associer aux configurations IP dans l’interface réseau. Une fois les deux objets créés, nous liez la configuration IP par défaut à l’objet MyASG. Enfin, nous créons une configuration IP dans l’interface réseau également liée à l’objet de groupe de sécurité d’application.

Paramètres

-ApplicationGatewayBackendAddressPool

Spécifie une collection de références de pool d’adresses principales application gateway auxquelles appartient cette configuration IP de l’interface réseau.

Propriétés du paramètre

Type:

PSApplicationGatewayBackendAddressPool[]

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

Jeux de paramètres

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

-ApplicationGatewayBackendAddressPoolId

Spécifie une collection de références de pool d’adresses principales application gateway auxquelles appartient cette configuration IP 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

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

-ApplicationSecurityGroup

Spécifie une collection de références de groupe de sécurité d’application auxquelles appartient cette configuration IP de l’interface réseau.

Propriétés du paramètre

Type:

PSApplicationSecurityGroup[]

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

Jeux de paramètres

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

-ApplicationSecurityGroupId

Spécifie une collection de références de groupe de sécurité d’application auxquelles appartient cette configuration IP 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

SetByResourceId
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
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

-GatewayLoadBalancerId

Référence de la ressource du fournisseur LoadBalancer de passerelle.

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

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

-LoadBalancerBackendAddressPool

Spécifie une collection de références de pool d’adresses principales de l’équilibreur de charge auxquelles appartient cette configuration IP de l’interface réseau.

Propriétés du paramètre

Type:

PSBackendAddressPool[]

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

Jeux de paramètres

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

-LoadBalancerBackendAddressPoolId

Spécifie une collection de références de pool d’adresses principales de l’équilibreur de charge auxquelles appartient cette configuration IP 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

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

-LoadBalancerInboundNatRule

Spécifie une collection de références de règle NAT (Load Balancer inbound Network Address Translation) auxquelles appartient cette configuration IP de l’interface réseau.

Propriétés du paramètre

Type:

PSInboundNatRule[]

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

Jeux de paramètres

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

-LoadBalancerInboundNatRuleId

Spécifie une collection de références de règle NAT entrante de l’équilibreur de charge auquel appartient cette configuration IP 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

SetByResourceId
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 la configuration IP 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:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-NetworkInterface

Spécifie un objet NetworkInterface . Cette applet de commande ajoute une configuration IP d’interface réseau à l’objet spécifié par ce paramètre.

Propriétés du paramètre

Type:PSNetworkInterface
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:True
Valeur du pipeline:True
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Primary

L’applet de commande Add-AzNetworkInterfaceIpConfig ajoute une configuration IP d’interface réseau à une interface réseau Azure.

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

-PrivateIpAddress

Spécifie l’adresse IP statique de la configuration IP 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é:False
Valeur des arguments restants:False

-PrivateIPAddressPrefixLength

Spécifie la longueur du préfixe d’adresse IP statique de la configuration IP de l’interface réseau.

Propriétés du paramètre

Type:

Nullable<T>[Int32]

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 d’adresse IP d’une configuration IP d’interface réseau. Les valeurs acceptables pour ce paramètre sont les suivantes :

  • IPv4
  • IPv6

Propriétés du paramètre

Type:String
Valeur par défaut:None
Valeurs acceptées:IPv4, IPv6
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

-PublicIpAddress

Spécifie un objet PublicIPAddress . Cette applet de commande crée une référence à une adresse IP publique à associer à cette configuration IP de l’interface réseau.

Propriétés du paramètre

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

Jeux de paramètres

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

-PublicIpAddressId

Cette applet de commande crée une référence à une adresse IP publique à associer à cette configuration IP 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

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

-Subnet

Spécifie un objet Subnet . Cette applet de commande crée une référence à un sous-réseau dans lequel cette configuration IP de l’interface réseau est créée.

Propriétés du paramètre

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

Jeux de paramètres

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

-SubnetId

Cette applet de commande crée une référence à un sous-réseau dans lequel cette configuration IP de l’interface réseau est créé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

SetByResourceId
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 courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.

Entrées

PSNetworkInterface

String

PSBackendAddressPool

PSInboundNatRule

PSApplicationGatewayBackendAddressPool

PSApplicationSecurityGroup

Sorties

PSNetworkInterface

Notes

  • Mots clés : azure, azurerm, arm, resource, management, manager, network, networking