Set-AzureRmApplicationGatewayFrontendIPConfig
Modifie une configuration d’adresse IP frontale.
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.
Syntax
Set-AzureRmApplicationGatewayFrontendIPConfig
-ApplicationGateway <PSApplicationGateway>
-Name <String>
[-PrivateIPAddress <String>]
[-SubnetId <String>]
[-PublicIPAddressId <String>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Set-AzureRmApplicationGatewayFrontendIPConfig
-ApplicationGateway <PSApplicationGateway>
-Name <String>
[-PrivateIPAddress <String>]
[-Subnet <PSSubnet>]
[-PublicIPAddress <PSPublicIpAddress>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Description
L’applet de commande Set-AzureRmApplicationGatewayFrontendIPConfig met à jour une configuration IP frontale. Une passerelle d’application prend en charge deux types d’adresses IP frontales :
- Adresses IP publiques
- Adresses IP privées pour lesquelles la configuration utilise l’équilibrage de charge interne (ILB) Une passerelle d’application peut avoir au maximum une adresse IP publique et une adresse IP privée. Une adresse IP publique et une adresse IP privée doivent être ajoutées séparément en tant qu’adresses IP frontales.
Exemples
Exemple 1 : Définir une adresse IP publique en tant qu’adresse IP frontale d’une passerelle d’application
PS C:\>$PublicIp = New-AzureRmPublicIpAddress -ResourceGroupName "ResourceGroup01" -Name "PublicIp01" -location "West US" -AllocationMethod Dynamic
PS C:\> $AppGw = Get-AzureRmApplicationGateway -Name "ApplicationGateway01" -ResourceGroupName "ResourceGroup01"
PS C:\> $AppGw = Set-AzureRmApplicationGatewayFrontendIPConfig -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 met à jour la configuration IP frontale nommée FrontEndIp01, pour la passerelle dans $AppGw, à l’aide de l’adresse stockée dans $PublicIp.
Exemple 2 : Définir une adresse IP privée statique comme adresse IP frontale d’une passerelle d’application
PS C:\>$VNet = Get-AzureRmvirtualNetwork -Name "VNet01" -ResourceGroupName "ResourceGroup01"
PS C:\> $Subnet = Get-AzureRmVirtualNetworkSubnetConfig -Name "Subnet01" -VirtualNetwork $VNet
PS C:\> $AppGw = Get-AzureRmApplicationGateway -Name "ApplicationGateway01" -ResourceGroupName "ResourceGroup01"
PS C:\> $AppGw = Set-AzureRmApplicationGatewayFrontendIPConfig -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 : Définir une adresse IP privée dynamique comme adresse IP frontale d’une passerelle d’application
PS C:\>$VNet = Get-AzureRmvirtualNetwork -Name "VNet01" -ResourceGroupName "ResourceGroup01"
PS C:\> $Subnet = Get-AzureRmVirtualNetworkSubnetConfig -Name "Subnet01" -VirtualNetwork $VNet
PS C:\> $AppGw = Get-AzureRmApplicationGateway -Name "ApplicationGateway01" -ResourceGroupName "ResourceGroup01"
PS C:\> $AppGw = Set-AzureRmApplicationGatewayFrontendIPConfig -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 un objet de passerelle d’application dans lequel modifier la configuration IP frontale.
Type: | PSApplicationGateway |
Position: | Named |
valeur par défaut: | None |
Obligatoire: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-DefaultProfile
Informations d’identification, compte, locataire et abonnement utilisés pour la communication avec Azure.
Type: | IAzureContextContainer |
Aliases: | AzureRmContext, AzureCredential |
Position: | Named |
valeur par défaut: | None |
Obligatoire: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Name
Spécifie le nom de la configuration IP frontale que cette applet de commande modifie.
Type: | String |
Position: | Named |
valeur par défaut: | None |
Obligatoire: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PrivateIPAddress
Spécifie l’adresse IP privée. 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 |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PublicIPAddress
Spécifie l’adresse IP publique.
Type: | PSPublicIpAddress |
Position: | Named |
valeur par défaut: | None |
Obligatoire: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PublicIPAddressId
Spécifie l’ID de l’adresse IP publique.
Type: | String |
Position: | Named |
valeur par défaut: | None |
Obligatoire: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Subnet
Spécifie le sous-réseau que la passerelle d’application utilise. Spécifiez ce paramètre si la passerelle utilise une adresse IP privée. Si l’adresse PrivateIPAddress est spécifiée, elle 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 |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SubnetId
Spécifie l’ID de sous-réseau. Spécifiez ce paramètre si la passerelle utilise une adresse 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: | String |
Position: | Named |
valeur par défaut: | None |
Obligatoire: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Entrées
Paramètres : ApplicationGateway (ByValue)