New-AzApplicationGatewayPathRuleConfig
Crée une règle de chemin d’accès de passerelle d’application.
Syntax
New-AzApplicationGatewayPathRuleConfig
-Name <String>
-Paths <String[]>
[-BackendAddressPoolId <String>]
[-BackendHttpSettingsId <String>]
[-RewriteRuleSetId <String>]
[-RedirectConfigurationId <String>]
[-FirewallPolicyId <String>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
New-AzApplicationGatewayPathRuleConfig
-Name <String>
-Paths <String[]>
[-BackendAddressPool <PSApplicationGatewayBackendAddressPool>]
[-BackendHttpSettings <PSApplicationGatewayBackendHttpSettings>]
[-RewriteRuleSet <PSApplicationGatewayRewriteRuleSet>]
[-RedirectConfiguration <PSApplicationGatewayRedirectConfiguration>]
[-FirewallPolicy <PSApplicationGatewayWebApplicationFirewallPolicy>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Description
L’applet de commande New-AzApplicationGatewayPathRuleConfig 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
$Gateway = Get-AzApplicationGateway -Name "ContosoApplicationGateway"
$AddressPool = New-AzApplicationGatewayBackendAddressPool -Name "ContosoAddressPool" -BackendIPAddresses "192.168.1.1", "192.168.1.2"
$HttpSettings = New-AzApplicationGatewayBackendHttpSetting -Name "ContosoHttpSettings" -Port 80 -Protocol "Http" -CookieBasedAffinity "Disabled"
$PathRuleConfig = New-AzApplicationGatewayPathRuleConfig -Name "base" -Paths "/base" -BackendAddressPool $AddressPool -BackendHttpSettings $HttpSettings
Add-AzApplicationGatewayUrlPathMapConfig -ApplicationGateway $Gateway -Name "ContosoUrlPathMap" -PathRules $PathRuleConfig -DefaultBackendAddressPool $AddressPool -DefaultBackendHttpSettings $HttpSettings
Ces commandes créent une règle de chemin d’accès de passerelle d’application, puis utilisent l’applet de commande Add-AzApplicationGatewayUrlPathMapConfig 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 $Http Paramètres) 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-AzApplicationGatewayUrlPathMapConfig pour ajouter les paramètres de configuration et la nouvelle règle de chemin contenue dans ces paramètres à ContosoApplicationGateway.
Exemple 2
$PathRuleConfig = New-AzApplicationGatewayPathRuleConfig -Name "base" -Paths "/base" -BackendAddressPool $AddressPool -BackendHttpSettings $HttpSettings -FirewallPolicy $firewallPolicy
Cette commande crée une règle de chemin avec le nom « base », les chemins en tant que « /base », backendAddressPool en tant que $AddressPool, BackendHttp Paramètres en tant que $Http Paramètres et FirewallPolicy en tant que $firewallPolicy.ngs et la nouvelle règle de chemin contenue dans ces paramètres pour 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-AzApplicationGatewayBackendAddressPool et de la syntaxe similaires à ceci : $AddressPool = New-AzApplicationGatewayBackendAddressPool -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 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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-AzApplicationGatewayBackendAddressPool. 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 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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-AzApplicationGatewayBackendHttp Paramètres et de la syntaxe similaires à ceci : $Http Paramètres = New-AzApplicationGatewayBackendHttp Paramètres -Name « ContosoHttp Paramètres » -Port 80 -Protocol « Http » -CookieBasedAffinity « Disabled » La variable résultante, $Http Paramètres, peut ensuite être utilisé comme valeur de paramètre pour le paramètre DefaultBackendAddressPool : -DefaultBackendHttp Paramètres $Http Paramètres 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 DefaultBackendHttp Paramètres Id dans la même commande.
Type: | PSApplicationGatewayBackendHttpSettings |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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-AzApplicationGatewayBackendHttp Paramètres. Une fois que vous avez l’ID, vous pouvez utiliser le paramètre DefaultBackendHttp Paramètres Id au lieu du paramètre DefaultBackendHttp Paramètres. Par exemple : -DefaultBackend Paramètres Id « /subscriptions/39c54063-01d3-4abf-8f4c-234777bc1f10/resourceGroups/appgw-rg/providers/Microsoft.Network/applicationGateways/appgwtest/backendHttp Paramètres Collection/ContosoHttp Paramètres » Les paramètres HTTP principaux configurent les 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 DefaultBackendHttp Paramètres dans la même commande.
Type: | String |
Position: | Named |
Default value: | None |
Required: | 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: | AzContext, AzureRmContext, AzureCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-FirewallPolicy
Spécifie la référence d’objet à une stratégie de pare-feu de niveau supérieur. La référence d’objet peut être créée à l’aide de l’applet de commande New-AzApplicationGatewayWebApplicationFirewallPolicy. $firewallPolicy = New-AzApplicationGatewayFirewallPolicy -Name « wafPolicy1 » -ResourceGroup « rgName » Une stratégie de pare-feu créée à l’aide du commandlet ci-dessus peut être référencée au niveau d’une règle de chemin d’accès. la commande ci-dessus créerait des paramètres de stratégie par défaut et des règles gérées. Au lieu des valeurs par défaut, les utilisateurs peuvent spécifier policy Paramètres, ManagedRules à l’aide de New-AzApplicationGatewayFirewallPolicy Paramètres et New-AzApplicationGatewayFirewallPolicyManagedRules respectivement.
Type: | PSApplicationGatewayWebApplicationFirewallPolicy |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-FirewallPolicyId
Spécifie l’ID d’une ressource de pare-feu d’application web de niveau supérieur existante.
Les ID de stratégie de pare-feu peuvent être retournés à l’aide de l’applet de commande Get-AzApplicationGatewayWebApplicationFirewallPolicy.
Une fois que nous avons l’ID, vous pouvez utiliser le paramètre FirewallPolicyId au lieu du paramètre FirewallPolicy .
Par exemple : -FirewallPolicyId /subscriptions/<subscription-id>/resourceGroups/<resource-group-id>/providers/Microsoft.Network/ApplicationGatewayWebApplicationFirewallPolicies/<firewallPolicyName>
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Paths
Spécifie une ou plusieurs règles de chemin d’accès application Gateway.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RedirectConfiguration
RedirectConfiguration d’Application Gateway
Type: | PSApplicationGatewayRedirectConfiguration |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RedirectConfigurationId
ID de La redirection de la passerelle d’application
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RewriteRuleSet
Application gateway RewriteRuleSet
Type: | PSApplicationGatewayRewriteRuleSet |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RewriteRuleSetId
ID de la passerelle Application Gateway RewriteRuleSet
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Entrées
None
Sorties
Liens associés
- Add-AzApplicationGatewayUrlPathMapConfig
- Get-AzApplicationGateway
- Get-AzApplicationGatewayUrlPathMapConfig
- New-AzApplicationGatewayBackendAddressPool
- New-AzApplicationGatewayBackendHttpSetting
- New-AzApplicationGatewayPathRuleConfig
- New-AzApplicationGatewayUrlPathMapConfig
- Remove-AzApplicationGatewayUrlPathMapConfig
- Set-AzApplicationGatewayUrlPathMapConfig
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour