Condividi tramite

New-AzApplicationGatewayPathRuleConfig

  • Riferimento
Modulo:
Az.Network

Crea una regola di percorso del gateway applicazione.

Sintassi

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>]

Descrizione

Il cmdlet New-AzApplicationGatewayPathRuleConfig crea una regola di percorso del gateway applicazione. Le regole create da questo cmdlet possono essere aggiunte a una raccolta di impostazioni di configurazione della mappa percorso URL e quindi assegnate a un gateway. Le impostazioni di configurazione della mappa del percorso vengono usate nel bilanciamento del carico del gateway applicazione.

Esempio

Esempio 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

Questi comandi creano una nuova regola del percorso del gateway applicazione e quindi usano il cmdlet Add-AzApplicationGatewayUrlPathMapConfig per assegnare tale regola a un gateway applicazione. A tale scopo, il primo comando crea un riferimento all'oggetto al gateway ContosoApplicationGateway. Questo riferimento all'oggetto viene archiviato in una variabile denominata $Gateway. I due comandi successivi creano un pool di indirizzi back-end e un oggetto impostazioni HTTP back-end; Questi oggetti (archiviati nelle variabili $AddressPool e $HttpSettings) sono necessari per creare un oggetto regola di percorso. Il quarto comando crea l'oggetto regola di percorso e viene archiviato in una variabile denominata $PathRuleConfig. Il quinto comando usa Add-AzApplicationGatewayUrlPathMapConfig per aggiungere le impostazioni di configurazione e la nuova regola di percorso contenuta in tali impostazioni a ContosoApplicationGateway.

Esempio 2

$PathRuleConfig = New-AzApplicationGatewayPathRuleConfig -Name "base" -Paths "/base" -BackendAddressPool $AddressPool -BackendHttpSettings $HttpSettings -FirewallPolicy $firewallPolicy

Questo comando crea una regola di percorso con nome "base", percorsi come "/base", BackendAddressPool come $AddressPool, BackendHttpSettings come $HttpSettings e FirewallPolicy come $firewallPolicy.ngs e la nuova regola di percorso contenuta in tali impostazioni in ContosoApplicationGateway.

Parametri

-BackendAddressPool

Specifica un riferimento a un oggetto a una raccolta di impostazioni del pool di indirizzi back-end da aggiungere alle impostazioni di configurazione delle regole del percorso del gateway. È possibile creare questo riferimento all'oggetto usando il cmdlet New-AzApplicationGatewayBackendAddressPool e la sintassi simile alla seguente: $AddressPool = New-AzApplicationGatewayBackendAddressPool -Name "ContosoAddressPool" -BackendIPAddresses "192.168.1.1", "192.168.1.2" Il comando precedente aggiunge due indirizzi IP (192.16.1.1 e 192.168.1.2) al pool di indirizzi. Si noti che l'indirizzo IP è racchiuso tra virgolette e separato tramite virgole. La variabile risultante, $AddressPool, può quindi essere usata come valore del parametro per il parametro DefaultBackendAddressPool . Il pool di indirizzi back-end rappresenta gli indirizzi IP nei server back-end. Questi indirizzi IP devono appartenere alla subnet della rete virtuale o devono essere indirizzi IP pubblici. Se si usa questo parametro non è possibile utilizzare il parametro DefaultBackendAddressPoolId nello stesso comando.

Tipo:PSApplicationGatewayBackendAddressPool
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-BackendAddressPoolId

Specifica l'ID di un pool di indirizzi back-end esistente che può essere aggiunto alle impostazioni di configurazione della regola del percorso del gateway. Gli ID del pool di indirizzi possono essere restituiti usando il cmdlet Get-AzApplicationGatewayBackendAddressPool. Dopo aver ottenuto l'ID, è possibile usare il parametro DefaultBackendAddressPoolId anziché il parametro DefaultBackendAddressPool . Ad esempio: -DefaultBackendAddressPoolId "/subscriptions/39c54063-01d3-4abf-8f4c-234777bc1f10/resourceGroups/appgw-rg/providers/Microsoft.Network/applicationGateways/appgwtest/backendAddressPools/ContosoAddressPool" Il pool di indirizzi back-end rappresenta gli indirizzi IP nei server back-end. Questi indirizzi IP devono appartenere alla subnet della rete virtuale o devono essere indirizzi IP pubblici.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-BackendHttpSettings

Specifica un riferimento a un oggetto a una raccolta di impostazioni HTTP back-end da aggiungere alle impostazioni di configurazione della regola del percorso del gateway. È possibile creare questo riferimento all'oggetto usando il cmdlet New-AzApplicationGatewayBackendHttpSettings e la sintassi simili a questa: $HttpSettings = New-AzApplicationGatewayBackendHttpSettings -Name "ContosoHttpSettings" -Port 80 -Protocol "Http" -CookieBasedAffinity "Disabled" La variabile risultante, $HttpSettings, può quindi essere usata come valore del parametro per DefaultBackendAddressPool parametro: -DefaultBackendHttpSettings $HttpSettings Le impostazioni HTTP back-end configurano proprietà come porta, protocollo e affinità basata su cookie per un pool back-end. Se si usa questo parametro non è possibile usare il parametro DefaultBackendHttpSettingsId nello stesso comando.

Tipo:PSApplicationGatewayBackendHttpSettings
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-BackendHttpSettingsId

Specifica l'ID di una raccolta di impostazioni HTTP back-end esistente che può essere aggiunta alle impostazioni di configurazione della regola del percorso del gateway. Gli ID delle impostazioni HTTP possono essere restituiti usando il cmdlet Get-AzApplicationGatewayBackendHttpSettings. Dopo aver ottenuto l'ID, è possibile usare il parametro DefaultBackendHttpSettingsId anziché il parametro DefaultBackendHttpSettings . Ad esempio: -DefaultBackendSettings ID "/subscriptions/39c54063-01d3-4abf-8f4c-2347777bc1f10/resourceGroups/appgw-rg/providers/Microsoft.Network/applicationGateways/appgwtest/backendHttpSettingsCollection/ContosoHttpSettings" Le impostazioni HTTP back-end configurano proprietà come porta, protocollo e affinità basata su cookie per un pool back-end. Se si usa questo parametro non è possibile usare il parametro DefaultBackendHttpSettings nello stesso comando.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DefaultProfile

Credenziali, account, tenant e sottoscrizione usati per la comunicazione con Azure.

Tipo:IAzureContextContainer
Alias:AzContext, AzureRmContext, AzureCredential
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-FirewallPolicy

Specifica il riferimento all'oggetto a un criterio firewall di primo livello. Il riferimento all'oggetto può essere creato usando il cmdlet New-AzApplicationGatewayWebApplicationFirewallPolicy. $firewallPolicy = New-AzApplicationGatewayFirewallPolicy -Name "wafPolicy1" -ResourceGroup "rgName" Un criterio firewall creato usando il commandlet precedente può essere indicato a livello di regola del percorso. il comando precedente creerebbe le impostazioni predefinite dei criteri e le regole gestite. Anziché i valori predefiniti, gli utenti possono specificare PolicySettings, ManagedRules usando rispettivamente New-AzApplicationGatewayFirewallPolicySettings e New-AzApplicationGatewayFirewallPolicyManagedRules.

Tipo:PSApplicationGatewayWebApplicationFirewallPolicy
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-FirewallPolicyId

Specifica l'ID di una risorsa web application firewall di primo livello esistente. Gli ID dei criteri del firewall possono essere restituiti usando il cmdlet Get-AzApplicationGatewayWebApplicationFirewallPolicy. Dopo aver ottenuto l'ID, è possibile usare il parametro FirewallPolicyId anziché il parametro FirewallPolicy . Ad esempio: -FirewallPolicyId /subscriptions/<subscription-id>/resourceGroups/<resource-group-id>/providers/Microsoft.Network/ApplicationGatewayWebApplicationFirewallPolicies/<firewallPolicyName>

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Name

Specifica il nome della configurazione della regola di percorso creata da questo cmdlet.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Paths

Specifica una o più regole di percorso del gateway applicazione.

Tipo:String[]
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-RedirectConfiguration

Reindirizzamento del gateway applicazioneConfigurazione

Tipo:PSApplicationGatewayRedirectConfiguration
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-RedirectConfigurationId

ID del gateway applicazione RedirectConfiguration

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-RewriteRuleSet

RewriteRuleSet del gateway applicazione

Tipo:PSApplicationGatewayRewriteRuleSet
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-RewriteRuleSetId

ID del gateway applicazione RewriteRuleSet

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Input

None

Output

PSApplicationGatewayPathRule