New-AzureRmApplicationGatewayPathRuleConfig
Crée une règle de chemin d’accès de passerelle d’application.
Avertissement
Le module AzureRM PowerShell a été officiellement déprécié 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.
Il est possible que le module AzureRM fonctionne encore, mais il ne fait plus l’objet de maintenance ni de support. L’utilisateur peut continuer à s’en servir s’il le souhaite, à ses propres risques. Consultez nos ressources sur la migration pour obtenir des conseils sur la transition vers le module Az.
Syntaxe
New-AzureRmApplicationGatewayPathRuleConfig
-Name <String>
-Paths <System.Collections.Generic.List`1[System.String]>
[-BackendAddressPoolId <String>]
[-BackendHttpSettingsId <String>]
[-RedirectConfigurationId <String>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] New-AzureRmApplicationGatewayPathRuleConfig
-Name <String>
-Paths <System.Collections.Generic.List`1[System.String]>
[-BackendAddressPool <PSApplicationGatewayBackendAddressPool>]
[-BackendHttpSettings <PSApplicationGatewayBackendHttpSettings>]
[-RedirectConfiguration <PSApplicationGatewayRedirectConfiguration>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] Description
L’applet de commande New-AzureRmApplicationGatewayPathRuleConfig crée une règle de chemin d’accès de passerelle d’application. Les règles créées par cette applet de commande peuvent être ajoutées à une collection de paramètres de configuration de mappage de chemin d’URL, puis affectées à une passerelle. Les paramètres de configuration de la carte de chemin d’accès sont utilisés dans l’équilibrage de charge de la passerelle d’application.
Exemples
Exemple 1
PS C:\>$Gateway = Get-AzureRmApplicationGateway -Name "ContosoApplicationGateway"
PS C:\> $AddressPool = New-AzureRmApplicationGatewayBackendAddressPool -Name "ContosoAddressPool" -BackendIPAddresses "192.168.1.1", "192.168.1.2"
PS C:\> $HttpSettings = New-AzureRmApplicationGatewayBackendHttpSettings -Name "ContosoHttpSetings" -Port 80 -Protocol "Http" -CookieBasedAffinity "Disabled"
PS C:\> $PathRuleConfig = New-AzureRmApplicationGatewayPathRuleConfig -Name "base" -Paths "/base" -BackendAddressPool $AddressPool -BackendHttpSettings $HttpSettings
PS C:\> Add-AzureRmApplicationGatewayUrlPathMapConfig -ApplicationGateway $Gateway -Name "ContosoUrlPathMap" -PathRules $PathRuleConfig -DefaultBackendAddressPool $AddressPool -DefaultBackendHttpSettings $HttpSettingsCes commandes créent une règle de chemin d’accès de passerelle d’application, puis utilisent l’applet de commande Add-AzureRmApplicationGatewayUrlPathMapConfig pour affecter cette règle à une passerelle d’application. Pour ce faire, la première commande crée une référence d’objet à la passerelle ContosoApplicationGateway. Cette référence d’objet est stockée dans une variable nommée $Gateway. Les deux commandes suivantes créent un pool d’adresses back-end et un objet de paramètres HTTP principal ; ces objets (stockés dans les variables $AddressPool et $HttpSettings) sont nécessaires pour créer un objet de règle de chemin d’accès. La quatrième commande crée l’objet de règle de chemin d’accès et est stockée dans une variable nommée $PathRuleConfig. La cinquième commande utilise Add-AzureRmApplicationGatewayUrlPathMapConfig pour ajouter les paramètres de configuration et la nouvelle règle de chemin contenue dans ces paramètres à ContosoApplicationGateway.
Paramètres
-BackendAddressPool
Spécifie une référence d’objet à une collection de paramètres de pool d’adresses back-end à ajouter aux paramètres de configuration des règles de chemin d’accès de passerelle.
Vous pouvez créer cette référence d’objet à l’aide de l’applet de commande New-AzureRmApplicationGatewayBackendAddressPool et de la syntaxe similaires à ceci : $AddressPool = New-AzureRmApplicationGatewayBackendAddressPool -Name "ContosoAddressPool" -BackendIPAddresses "192.168.1.1", "192.168.1.2" La commande précédente ajoute deux adresses IP (192.16.1.1 et 192.168.1.2) au pool d’adresses.
Notez que l’adresse IP est placée entre guillemets et séparées par des virgules.
La variable résultante, $AddressPool, peut ensuite être utilisée comme valeur de paramètre pour le paramètre DefaultBackendAddressPool .
Le pool d’adresses back-end représente les adresses IP sur les serveurs principaux.
Ces adresses IP doivent appartenir au sous-réseau de réseau virtuel ou doivent être des adresses IP publiques.
Si vous utilisez ce paramètre, vous ne pouvez pas utiliser le paramètre DefaultBackendAddressPoolId dans la même commande.
| Type: | PSApplicationGatewayBackendAddressPool |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-BackendAddressPoolId
Spécifie l’ID d’un pool d’adresses back-end existant qui peut être ajouté aux paramètres de configuration des règles de chemin d’accès de passerelle. Les ID de pool d’adresses peuvent être retournés à l’aide de l’applet de commande Get-AzureRmApplicationGatewayBackendAddressPool. Une fois que vous avez l’ID, vous pouvez utiliser le paramètre DefaultBackendAddressPoolId au lieu du paramètre DefaultBackendAddressPool . Par exemple : -DefaultBackendAddressPoolId « /subscriptions/39c54063-01d3-4abf-8f4c-234777bc1f10/resourceGroups/appgw-rg/providers/Microsoft.Network/applicationGateways/appgwtest/backendAddressPools/ContosoAddressPool » Le pool d’adresses principal représente les adresses IP sur les serveurs principaux. Ces adresses IP doivent appartenir au sous-réseau de réseau virtuel ou doivent être des adresses IP publiques.
| 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 |
-BackendHttpSettings
Spécifie une référence d’objet à une collection de paramètres HTTP principaux à ajouter aux paramètres de configuration de règle de chemin d’accès de passerelle. Vous pouvez créer cette référence d’objet à l’aide de l’applet de commande New-AzureRmApplicationGatewayBackendHttpSettings et de la syntaxe similaires à ceci : $HttpSettings = New-AzureRmApplicationGatewayBackendHttpSettings -Name « ContosoHttpSetings » -Port 80 -Protocol « Http » -CookieBasedAffinity « Disabled » La variable résultante, $HttpSettings, peut ensuite être utilisée comme valeur de paramètre pour DefaultBackendAddressPool paramètre : -DefaultBackendHttpSettings $HttpSettings Les paramètres HTTP principaux configurent les propriétés telles que le port, le protocole et l’affinité basée sur les cookies pour un pool principal. Si vous utilisez ce paramètre, vous ne pouvez pas utiliser le paramètre DefaultBackendHttpSettingsId dans la même commande.
| Type: | PSApplicationGatewayBackendHttpSettings |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-BackendHttpSettingsId
Spécifie l’ID d’une collection de paramètres HTTP back-end existante qui peut être ajoutée aux paramètres de configuration de règle de chemin d’accès de passerelle. Les ID de paramètre HTTP peuvent être retournés à l’aide de l’applet de commande Get-AzureRmApplicationGatewayBackendHttpSettings. Une fois que vous avez l’ID, vous pouvez utiliser le paramètre DefaultBackendHttpSettingsId au lieu du paramètre DefaultBackendHttpSettings . Par exemple : -DefaultBackendSettings Id « /subscriptions/39c54063-01d3-4abf-8f4c-234777bc1f10/resourceGroups/appgw-rg/providers/Microsoft.Network/applicationGateways/appgwtest/backendHttpSettingsCollection/ContosoHttpSettings » Les paramètres HTTP principaux configurent des propriétés telles que le port, protocole et affinité basée sur les cookies pour un pool principal. Si vous utilisez ce paramètre, vous ne pouvez pas utiliser le paramètre DefaultBackendHttpSettings dans la même commande.
| 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 |
-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 |
-Name
Spécifie le nom de la configuration de la règle de chemin d’accès que cette applet de commande crée.
| 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 |
-Paths
Spécifie une ou plusieurs règles de chemin d’accès application Gateway.
| Type: | List<T>[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 |
-RedirectConfiguration
RedirectConfiguration d’Application Gateway
| Type: | PSApplicationGatewayRedirectConfiguration |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-RedirectConfigurationId
ID de La redirection 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
None
Sorties
Liens associés
- Add-AzureRmApplicationGatewayUrlPathMapConfig
- Get-AzureRmApplicationGateway
- Get-AzureRmApplicationGatewayUrlPathMapConfig
- New-AzureRmApplicationGatewayBackendAddressPool
- New-AzureRmApplicationGatewayBackendHttpSettings
- New-AzureRmApplicationGatewayPathRuleConfig
- New-AzureRmApplicationGatewayUrlPathMapConfig
- Remove-AzureRmApplicationGatewayUrlPathMapConfig
- Set-AzureRmApplicationGatewayUrlPathMapConfig