Partager via

Add-AzApplicationGatewayFrontendIPConfig

  • Référence
Module:
Az.Network

Ajoute une configuration IP frontale à une passerelle d’application.

Syntaxe

Add-AzApplicationGatewayFrontendIPConfig
   -ApplicationGateway <PSApplicationGateway>
   -Name <String>
   [-PrivateIPAddress <String>]
   [-SubnetId <String>]
   [-PublicIPAddressId <String>]
   [-PrivateLinkConfigurationId <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Add-AzApplicationGatewayFrontendIPConfig
   -ApplicationGateway <PSApplicationGateway>
   -Name <String>
   [-PrivateIPAddress <String>]
   [-Subnet <PSSubnet>]
   [-PublicIPAddress <PSPublicIpAddress>]
   [-PrivateLinkConfiguration <PSApplicationGatewayPrivateLinkConfiguration>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Description

L’applet de commande Add-AzApplicationGatewayFrontendIPConfig ajoute une configuration IP frontale à une passerelle d’application. Une passerelle d’application prend en charge deux types de configurations IP frontales :

  • Adresses IP publiques
  • Adresses IP privées utilisant l’équilibrage de charge interne (ILB) Une passerelle d’application peut avoir au maximum une adresse IP publique et une adresse IP privée. Ajoutez l’adresse IP publique et l’adresse IP privée en tant qu’adresses IP frontales distinctes.

Exemples

Exemple 1 : Ajouter une adresse IP publique en tant qu’adresse IP frontale

$PublicIp = New-AzPublicIpAddress -ResourceGroupName "ResourceGroup01" -Name "PublicIp01" -location "West US" -AllocationMethod Dynamic
$AppGw = Get-AzApplicationGateway -Name "ApplicationGateway01" -ResourceGroupName "ResourceGroup01"
$AppGw = Add-AzApplicationGatewayFrontendIPConfig -ApplicationGateway $AppGw -Name "FrontEndIp01" -PublicIPAddress $PublicIp

La première commande crée un objet d’adresse IP publique et le stocke dans la variable $PublicIp. La deuxième commande obtient la passerelle d’application nommée ApplicationGateway01 qui appartient au groupe de ressources nommé ResourceGroup01 et la stocke dans la variable $AppGw. La troisième commande ajoute la configuration IP frontale nommée FrontEndIp01, pour la passerelle dans $AppGw, à l’aide de l’adresse stockée dans $PublicIp.

Exemple 2 : Ajouter une adresse IP privée statique comme adresse IP frontale

$VNet = Get-AzVirtualNetwork -Name "VNet01" -ResourceGroupName "ResourceGroup01"
$Subnet = Get-AzVirtualNetworkSubnetConfig -Name "Subnet01" -VirtualNetwork $VNet
$AppGw = Get-AzApplicationGateway -Name "ApplicationGateway01" -ResourceGroupName "ResourceGroup01"
$AppGw = Add-AzApplicationGatewayFrontendIPConfig -ApplicationGateway $AppGw -Name "FrontendIP02" -Subnet $Subnet -PrivateIPAddress 10.0.1.1

La première commande obtient un réseau virtuel nommé VNet01 qui appartient au groupe de ressources nommé ResourceGroup01 et le stocke dans la variable $VNet. La deuxième commande obtient une configuration de sous-réseau nommée Subnet01 à l’aide de $VNet à partir de la première commande et la stocke dans la variable $Subnet. La troisième commande obtient la passerelle d’application nommée ApplicationGateway01 qui appartient au groupe de ressources nommé ResourceGroup01 et la stocke dans la variable $AppGw. La quatrième commande ajoute une configuration IP frontale nommée FrontendIP02 à l’aide de $Subnet à partir de la deuxième commande et de l’adresse IP privée 10.0.1.1.

Exemple 3 : Ajouter une adresse IP privée dynamique en tant qu’adresse IP frontale

$VNet = Get-AzVirtualNetwork -Name "VNet01" -ResourceGroupName "ResourceGroup01"
$Subnet = Get-AzVirtualNetworkSubnetConfig -Name "Subnet01" -VirtualNetwork $VNet
$AppGw = Get-AzApplicationGateway -Name "ApplicationGateway01" -ResourceGroupName "ResourceGroup01"
$AppGw = Add-AzApplicationGatewayFrontendIPConfig -ApplicationGateway $AppGw -Name "FrontendIP02" -Subnet $Subnet

La première commande obtient un réseau virtuel nommé VNet01 qui appartient au groupe de ressources nommé ResourceGroup01 et le stocke dans la variable $VNet. La deuxième commande obtient une configuration de sous-réseau nommée Subnet01 à l’aide de $VNet à partir de la première commande et la stocke dans la variable $Subnet. La troisième commande obtient la passerelle d’application nommée ApplicationGateway01 qui appartient au groupe de ressources nommé ResourceGroup01 et la stocke dans la variable $AppGw. La quatrième commande ajoute une configuration IP frontale nommée FrontendIP02 à l’aide de $Subnet à partir de la deuxième commande.

Paramètres

-ApplicationGateway

Spécifie la passerelle d’application à laquelle cette applet de commande ajoute une configuration IP frontale.

Type:PSApplicationGateway
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
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:AzContext, 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

-Name

Spécifie le nom de la configuration IP frontale à ajouter.

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

-PrivateIPAddress

Spécifie l’adresse IP privée à ajouter en tant qu’adresse IP frontale pour la passerelle d’application. Si elle est spécifiée, cette adresse IP est allouée statiquement à partir du sous-réseau.

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

-PrivateLinkConfiguration

PrivateLinkConfiguration

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

-PrivateLinkConfigurationId

PrivateLinkConfigurationId

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

-PublicIPAddress

Spécifie l’adresse IP publique que cette applet de commande ajoute en tant qu’adresse IP frontale pour la passerelle d’application.

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

-PublicIPAddressId

Spécifie l’ID de l’adresse IP publique que cette applet de commande ajoute en tant qu’adresse IP frontale pour la passerelle d’application.

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

-Subnet

Spécifie le sous-réseau que cette applet de commande ajoute en tant que configuration IP frontale. Si vous spécifiez ce paramètre, cela implique que la passerelle d’application prend en charge une configuration IP privée. Si le paramètre PrivateIPAddress est spécifié, il doit appartenir à ce sous-réseau. Si PrivateIPAddress n’est pas spécifié, l’une des adresses IP de ce sous-réseau est récupérée dynamiquement comme adresse IP frontale de la passerelle d’application.

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

-SubnetId

Spécifie l’ID de sous-réseau que cette applet de commande ajoute en tant que configuration IP frontale. Le passage d’un sous-réseau implique une adresse IP privée. Si le paramètre PrivateIPAddress est spécifié, il doit appartenir à ce sous-réseau. Sinon, l’une des adresses IP de ce sous-réseau est récupérée dynamiquement en tant qu’adresse IP frontale de la passerelle d’application.

Type:String
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

PSApplicationGateway

Sorties

PSApplicationGateway