Partager via

New-AzureRmApplicationGateway

  • Référence
Module:
AzureRM.Network

Crée une passerelle d’application.

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

New-AzureRmApplicationGateway
   -Name <String>
   -ResourceGroupName <String>
   -Location <String>
   -Sku <PSApplicationGatewaySku>
   [-SslPolicy <PSApplicationGatewaySslPolicy>]
   -GatewayIPConfigurations <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSApplicationGatewayIPConfiguration]>
   [-SslCertificates <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSApplicationGatewaySslCertificate]>]
   [-AuthenticationCertificates <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSApplicationGatewayAuthenticationCertificate]>]
   [-TrustedRootCertificate <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSApplicationGatewayTrustedRootCertificate]>]
   [-FrontendIPConfigurations <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSApplicationGatewayFrontendIPConfiguration]>]
   -FrontendPorts <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSApplicationGatewayFrontendPort]>
   [-Probes <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSApplicationGatewayProbe]>]
   -BackendAddressPools <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSApplicationGatewayBackendAddressPool]>
   -BackendHttpSettingsCollection <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSApplicationGatewayBackendHttpSettings]>
   -HttpListeners <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSApplicationGatewayHttpListener]>
   [-UrlPathMaps <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSApplicationGatewayUrlPathMap]>]
   -RequestRoutingRules <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSApplicationGatewayRequestRoutingRule]>
   [-RedirectConfigurations <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSApplicationGatewayRedirectConfiguration]>]
   [-WebApplicationFirewallConfiguration <PSApplicationGatewayWebApplicationFirewallConfiguration>]
   [-AutoscaleConfiguration <PSApplicationGatewayAutoscaleConfiguration>]
   [-EnableHttp2]
   [-EnableFIPS]
   [-Zone <System.Collections.Generic.List`1[System.String]>]
   [-Tag <Hashtable>]
   [-Force]
   [-AsJob]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

L’applet de commande New-AzureRmApplicationGateway crée une passerelle d’application Azure. Une passerelle d’application nécessite les éléments suivants :

  • Un groupe de ressources.
  • Un réseau virtuel.
  • Pool de serveurs principaux contenant les adresses IP des serveurs principaux.
  • Paramètres du pool de serveurs principaux. Chaque pool a des paramètres tels que le port, le protocole et l’affinité basée sur les cookies, qui sont appliqués à tous les serveurs du pool.
  • Adresses IP frontales, qui sont les adresses IP ouvertes sur la passerelle d’application. Une adresse IP frontale peut être une adresse IP publique ou une adresse IP interne.
  • Ports frontaux, qui sont les ports publics ouverts sur la passerelle d’application. Le trafic qui atteint ces ports est redirigé vers les serveurs principaux.
  • Règle de routage des requêtes qui lie l’écouteur et le pool de serveurs back-end. La règle définit le pool de serveurs principaux vers lequel le trafic doit être dirigé lorsqu’il atteint un écouteur particulier. Un écouteur dispose d’un port frontal, d’une adresse IP frontale, d’une adresse IP frontale, d’un protocole (HTTP ou HTTPS) et d’un nom de certificat SSL (si vous configurez le déchargement SSL).

Exemples

Exemple 1 : Créer une passerelle d’application

PS C:\> $ResourceGroup = New-AzureRmResourceGroup -Name "ResourceGroup01" -Location "West US" -Tag @{Name = "Department"; Value = "Marketing"} 
PS C:\> $Subnet = New-AzureRmVirtualNetworkSubnetConfig -Name "Subnet01" -AddressPrefix 10.0.0.0/24
PS C:\> $VNet = New-AzureRmvirtualNetwork -Name "VNet01" -ResourceGroupName "ResourceGroup01" -Location "West US" -AddressPrefix 10.0.0.0/16 -Subnet $Subnet
PS C:\> $VNet = Get-AzureRmvirtualNetwork -Name "VNet01" -ResourceGroupName "ResourceGroup01"
PS C:\> $Subnet = Get-AzureRmVirtualNetworkSubnetConfig -Name $Subnet01 -VirtualNetwork $VNet 
PS C:\> $GatewayIPconfig = New-AzureRmApplicationGatewayIPConfiguration -Name "GatewayIp01" -Subnet $Subnet
PS C:\> $Pool = New-AzureRmApplicationGatewayBackendAddressPool -Name "Pool01" -BackendIPAddresses 10.10.10.1, 10.10.10.2, 10.10.10.3
PS C:\> $PoolSetting = New-AzureRmApplicationGatewayBackendHttpSettings -Name "PoolSetting01"  -Port 80 -Protocol "Http" -CookieBasedAffinity "Disabled"
PS C:\> $FrontEndPort = New-AzureRmApplicationGatewayFrontendPort -Name "FrontEndPort01"  -Port 80
# Create a public IP address
PS C:\> $PublicIp = New-AzureRmPublicIpAddress -ResourceGroupName "ResourceGroup01" -Name "PublicIpName01" -Location "West US" -AllocationMethod "Dynamic"
PS C:\> $FrontEndIpConfig = New-AzureRmApplicationGatewayFrontendIPConfig -Name "FrontEndConfig01" -PublicIPAddress $PublicIp
PS C:\> $Listener = New-AzureRmApplicationGatewayHttpListener -Name "ListenerName01"  -Protocol "Http" -FrontendIpConfiguration $FrontEndIpConfig -FrontendPort $FrontEndPort
PS C:\> $Rule = New-AzureRmApplicationGatewayRequestRoutingRule -Name "Rule01" -RuleType basic -BackendHttpSettings $PoolSetting -HttpListener $Listener -BackendAddressPool $Pool
PS C:\> $Sku = New-AzureRmApplicationGatewaySku -Name "Standard_Small" -Tier Standard -Capacity 2
PS C:\> $Gateway = New-AzureRmApplicationGateway -Name "AppGateway01" -ResourceGroupName "ResourceGroup01" -Location "West US" -BackendAddressPools $Pool -BackendHttpSettingsCollection $PoolSetting -FrontendIpConfigurations $FrontEndIpConfig  -GatewayIpConfigurations $GatewayIpConfig -FrontendPorts $FrontEndPort -HttpListeners $Listener -RequestRoutingRules $Rule -Sku $Sku

L’exemple suivant crée une passerelle Application Gateway en créant d’abord un groupe de ressources et un réseau virtuel, ainsi que les éléments suivants :

  • Un pool de serveurs back-end
  • Paramètres du pool de serveurs principaux
  • Ports frontaux
  • Adresses IP frontales
  • Une règle de routage de requête Ces quatre commandes créent un réseau virtuel. La première commande crée une configuration de sous-réseau. La deuxième commande crée un réseau virtuel. La troisième commande vérifie la configuration du sous-réseau et la quatrième commande vérifie que le réseau virtuel est créé avec succès. Les commandes suivantes créent la passerelle Application Gateway. La première commande crée une configuration IP nommée GatewayIp01 pour le sous-réseau créé précédemment. La deuxième commande crée un pool de serveurs principaux nommé Pool01 avec une liste d’adresses IP principales et stocke le pool dans la variable $Pool. La troisième commande crée les paramètres du pool de serveurs principaux et stocke les paramètres dans la variable $PoolSetting. La commande de sortie crée un port frontal sur le port 80, le nomme FrontEndPort01 et stocke le port dans la variable $FrontEndPort. La cinquième commande crée une adresse IP publique à l’aide de New-AzureRmPublicIpAddress. La sixième commande crée une configuration IP frontale à l’aide de $PublicIp, la nomme FrontEndPortConfig01 et la stocke dans la variable $FrontEndIpConfig. La septième commande crée un écouteur à l’aide de la $FrontEndIpConfig $FrontEndPort créée précédemment. La huitième commande crée une règle pour l’écouteur. La neuvième commande définit la référence SKU. La dixième commande crée la passerelle à l’aide des objets définis par les commandes précédentes.

Paramètres

-AsJob

Exécuter l’applet de commande en arrière-plan

Type:SwitchParameter
Position:Named
valeur par défaut:None
Obligatoire:False
Accept pipeline input:False
Accept wildcard characters:False

-AuthenticationCertificates

Spécifie les certificats d’authentification pour la passerelle d’application.

Type:List<T>[PSApplicationGatewayAuthenticationCertificate]
Position:Named
valeur par défaut:None
Obligatoire:False
Accept pipeline input:True
Accept wildcard characters:False

-AutoscaleConfiguration

Configuration de la mise à l’échelle automatique

Type:PSApplicationGatewayAutoscaleConfiguration
Position:Named
valeur par défaut:None
Obligatoire:False
Accept pipeline input:True
Accept wildcard characters:False

-BackendAddressPools

Spécifie la liste des pools d’adresses back-end pour la passerelle d’application.

Type:List<T>[PSApplicationGatewayBackendAddressPool]
Position:Named
valeur par défaut:None
Obligatoire:True
Accept pipeline input:True
Accept wildcard characters:False

-BackendHttpSettingsCollection

Spécifie la liste des paramètres HTTP principaux pour la passerelle d’application.

Type:List<T>[PSApplicationGatewayBackendHttpSettings]
Position:Named
valeur par défaut:None
Obligatoire:True
Accept pipeline input:True
Accept wildcard characters:False

-Confirm

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

Type:SwitchParameter
Aliases:cf
Position:Named
valeur par défaut:False
Obligatoire:False
Accept pipeline input:False
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

-EnableFIPS

Indique si FIPS est activé.

Type:SwitchParameter
Position:Named
valeur par défaut:None
Obligatoire:False
Accept pipeline input:False
Accept wildcard characters:False

-EnableHttp2

Indique si HTTP2 est activé.

Type:SwitchParameter
Position:Named
valeur par défaut:None
Obligatoire:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

Force l’exécution de la commande sans demander la confirmation de l’utilisateur.

Type:SwitchParameter
Position:Named
valeur par défaut:None
Obligatoire:False
Accept pipeline input:False
Accept wildcard characters:False

-FrontendIPConfigurations

Spécifie une liste de configurations IP frontales pour la passerelle d’application.

Type:List<T>[PSApplicationGatewayFrontendIPConfiguration]
Position:Named
valeur par défaut:None
Obligatoire:False
Accept pipeline input:True
Accept wildcard characters:False

-FrontendPorts

Spécifie une liste de ports frontaux pour la passerelle d’application.

Type:List<T>[PSApplicationGatewayFrontendPort]
Position:Named
valeur par défaut:None
Obligatoire:True
Accept pipeline input:True
Accept wildcard characters:False

-GatewayIPConfigurations

Spécifie une liste de configurations IP pour la passerelle d’application.

Type:List<T>[PSApplicationGatewayIPConfiguration]
Position:Named
valeur par défaut:None
Obligatoire:True
Accept pipeline input:True
Accept wildcard characters:False

-HttpListeners

Spécifie une liste d’écouteurs HTTP pour la passerelle d’application.

Type:List<T>[PSApplicationGatewayHttpListener]
Position:Named
valeur par défaut:None
Obligatoire:True
Accept pipeline input:True
Accept wildcard characters:False

-Location

Spécifie la région dans laquelle créer la passerelle Application Gateway.

Type:String
Position:Named
valeur par défaut:None
Obligatoire:True
Accept pipeline input:True
Accept wildcard characters:False

-Name

Spécifie le nom de la passerelle d’application.

Type:String
Aliases:ResourceName
Position:Named
valeur par défaut:None
Obligatoire:True
Accept pipeline input:True
Accept wildcard characters:False

-Probes

Spécifie des sondes pour la passerelle Application Gateway.

Type:List<T>[PSApplicationGatewayProbe]
Position:Named
valeur par défaut:None
Obligatoire:False
Accept pipeline input:True
Accept wildcard characters:False

-RedirectConfigurations

Liste de la configuration de redirection

Type:List<T>[PSApplicationGatewayRedirectConfiguration]
Position:Named
valeur par défaut:None
Obligatoire:False
Accept pipeline input:True
Accept wildcard characters:False

-RequestRoutingRules

Spécifie la liste des règles de routage des demandes pour la passerelle d’application.

Type:List<T>[PSApplicationGatewayRequestRoutingRule]
Position:Named
valeur par défaut:None
Obligatoire:True
Accept pipeline input:True
Accept wildcard characters:False

-ResourceGroupName

Spécifie le nom du groupe de ressources dans lequel créer la passerelle d’application.

Type:String
Position:Named
valeur par défaut:None
Obligatoire:True
Accept pipeline input:True
Accept wildcard characters:False

-Sku

Spécifie l’unité de conservation de stock (SKU) de la passerelle d’application.

Type:PSApplicationGatewaySku
Position:Named
valeur par défaut:None
Obligatoire:True
Accept pipeline input:True
Accept wildcard characters:False

-SslCertificates

Spécifie la liste des certificats SSL (Secure Sockets Layer) pour la passerelle d’application.

Type:List<T>[PSApplicationGatewaySslCertificate]
Position:Named
valeur par défaut:None
Obligatoire:False
Accept pipeline input:True
Accept wildcard characters:False

-SslPolicy

Spécifie une stratégie SSL pour la passerelle Application Gateway.

Type:PSApplicationGatewaySslPolicy
Position:Named
valeur par défaut:None
Obligatoire:False
Accept pipeline input:True
Accept wildcard characters:False

-Tag

Paires clé-valeur sous la forme d’une table de hachage. Par exemple : @{key0="value0 » ; key1=$null ; key2="value2"}

Type:Hashtable
Position:Named
valeur par défaut:None
Obligatoire:False
Accept pipeline input:True
Accept wildcard characters:False

-TrustedRootCertificate

Liste des certificats racines approuvés

Type:List<T>[PSApplicationGatewayTrustedRootCertificate]
Position:Named
valeur par défaut:None
Obligatoire:False
Accept pipeline input:True
Accept wildcard characters:False

-UrlPathMaps

Spécifie des mappages de chemins d’URL pour la passerelle d’application.

Type:List<T>[PSApplicationGatewayUrlPathMap]
Position:Named
valeur par défaut:None
Obligatoire:False
Accept pipeline input:True
Accept wildcard characters:False

-WebApplicationFirewallConfiguration

Spécifie une configuration de pare-feu d’applications web (WAF). Vous pouvez utiliser l’applet de commande Get-AzureRmApplicationGatewayWebApplicationFirewallConfiguration pour obtenir un WAF.

Type:PSApplicationGatewayWebApplicationFirewallConfiguration
Position:Named
valeur par défaut:None
Obligatoire:False
Accept pipeline input:True
Accept wildcard characters: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
Aliases:wi
Position:Named
valeur par défaut:False
Obligatoire:False
Accept pipeline input:False
Accept wildcard characters:False

-Zone

Liste des zones de disponibilité indiquant à partir de laquelle la passerelle d’application doit provenir.

Type:List<T>[String]
Position:Named
valeur par défaut:None
Obligatoire:False
Accept pipeline input:False
Accept wildcard characters:False

Entrées

String

PSApplicationGatewaySku

PSApplicationGatewaySslPolicy

List<T>[[Microsoft.Azure.Commands.Network.Models.PSApplicationGatewayIPConfiguration, Microsoft.Azure.Commands.Network, Version=6.4.1.0, Culture=neutral, PublicKeyToken=null]]

List<T>[[Microsoft.Azure.Commands.Network.Models.PSApplicationGatewaySslCertificate, Microsoft.Azure.Commands.Network, Version=6.4.1.0, Culture=neutral, PublicKeyToken=null]]

List<T>[[Microsoft.Azure.Commands.Network.Models.PSApplicationGatewayAuthenticationCertificate, Microsoft.Azure.Commands.Network, Version=6.4.1.0, Culture=neutral, PublicKeyToken=null]]

List<T>[[Microsoft.Azure.Commands.Network.Models.PSApplicationGatewayFrontendIPConfiguration, Microsoft.Azure.Commands.Network, Version=6.4.1.0, Culture=neutral, PublicKeyToken=null]]

List<T>[[Microsoft.Azure.Commands.Network.Models.PSApplicationGatewayFrontendPort, Microsoft.Azure.Commands.Network, Version=6.4.1.0, Culture=neutral, PublicKeyToken=null]]

List<T>[[Microsoft.Azure.Commands.Network.Models.PSApplicationGatewayProbe, Microsoft.Azure.Commands.Network, Version=6.4.1.0, Culture=neutral, PublicKeyToken=null]]

List<T>[[Microsoft.Azure.Commands.Network.Models.PSApplicationGatewayBackendAddressPool, Microsoft.Azure.Commands.Network, Version=6.4.1.0, Culture=neutral, PublicKeyToken=null]]

List<T>[[Microsoft.Azure.Commands.Network.Models.PSApplicationGatewayBackendHttpSettings, Microsoft.Azure.Commands.Network, Version=6.4.1.0, Culture=neutral, PublicKeyToken=null]]

List<T>[[Microsoft.Azure.Commands.Network.Models.PSApplicationGatewayHttpListener, Microsoft.Azure.Commands.Network, Version=6.4.1.0, Culture=neutral, PublicKeyToken=null]]

List<T>[[Microsoft.Azure.Commands.Network.Models.PSApplicationGatewayUrlPathMap, Microsoft.Azure.Commands.Network, Version=6.4.1.0, Culture=neutral, PublicKeyToken=null]]

List<T>[[Microsoft.Azure.Commands.Network.Models.PSApplicationGatewayRequestRoutingRule, Microsoft.Azure.Commands.Network, Version=6.4.1.0, Culture=neutral, PublicKeyToken=null]]

List<T>[[Microsoft.Azure.Commands.Network.Models.PSApplicationGatewayRedirectConfiguration, Microsoft.Azure.Commands.Network, Version=6.4.1.0, Culture=neutral, PublicKeyToken=null]]

PSApplicationGatewayWebApplicationFirewallConfiguration

Hashtable

Sorties

PSApplicationGateway