New-AzureRmApplicationGatewayPathRuleConfig
Crea una regola di percorso del gateway applicazione.
Avviso
Il modulo AzureRM PowerShell è stato ufficialmente deprecato a partire dal 29 febbraio 2024. È consigliabile eseguire la migrazione da AzureRM al modulo Az PowerShell per garantire il supporto e gli aggiornamenti continui.
Anche se il modulo AzureRM può ancora funzionare, non è più gestito o supportato, posizionando qualsiasi uso continuo a discrezione e rischio dell'utente. Per indicazioni sulla transizione al modulo Az, vedere le risorse di migrazione.
Sintassi
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>] Descrizione
Il cmdlet New-AzureRmApplicationGatewayPathRuleConfig 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
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 $HttpSettingsQuesti comandi creano una nuova regola di percorso del gateway applicazione e quindi usano il cmdlet Add-AzureRmApplicationGatewayUrlPathMapConfig 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 $Http Impostazioni) 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-AzureRmApplicationGatewayUrlPathMapConfig per aggiungere le impostazioni di configurazione e la nuova regola di percorso contenuta in tali impostazioni a 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-AzureRmApplicationGatewayBackendAddressPool e la sintassi simile alla seguente: $AddressPool = New-AzureRmApplicationGatewayBackendAddressPool -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.
| Type: | PSApplicationGatewayBackendAddressPool |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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-AzureRmApplicationGatewayBackendAddressPool. 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.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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-AzureRmApplicationGatewayBackendHttp Impostazioni sintassi simile alla seguente: $Http Impostazioni = New-AzureRmApplicationGatewayBackendHttp Impostazioni -Name "ContosoHttpSetings" -Port 80 -Protocol "Http" -CookieBasedAffinity "Disabled" Variabile risultante, $Http Impostazioni, può quindi essere usato come valore del parametro per il parametro DefaultBackendAddressPool: -DefaultBackendHttp Impostazioni $Http Impostazioni 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 DefaultBackendHttp Impostazioni Id nello stesso comando.
| Type: | PSApplicationGatewayBackendHttpSettings |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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-AzureRmApplicationGatewayBackendHttp Impostazioni. Dopo aver ottenuto l'ID, è possibile usare il parametro DefaultBackendHttp Impostazioni Id anziché il parametro DefaultBackendHttp Impostazioni. Ad esempio: -DefaultBackend Impostazioni ID "/subscriptions/39c54063-01d3-4abf-8f4c-234777bc1f10/resourceGroups/appgw-rg/providers/Microsoft.Network/applicationGateways/appgwtest/backendHttp Impostazioni Collection/ContosoHttp Impostazioni" 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 DefaultBackendHttp Impostazioni nello stesso comando.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DefaultProfile
Credenziali, account, tenant e sottoscrizione usati per la comunicazione con Azure.
| Type: | IAzureContextContainer |
| Aliases: | AzureRmContext, AzureCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Name
Specifica il nome della configurazione della regola di percorso creata da questo cmdlet.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Paths
Specifica una o più regole di percorso del gateway applicazione.
| Type: | List<T>[String] |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RedirectConfiguration
Reindirizzamento del gateway applicazioneConfigurazione
| Type: | PSApplicationGatewayRedirectConfiguration |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RedirectConfigurationId
ID del gateway applicazione RedirectConfiguration
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Input
None
Output
Collegamenti correlati
- Add-AzureRmApplicationGatewayUrlPathMapConfig
- Get-AzureRmApplicationGateway
- Get-AzureRmApplicationGatewayUrlPathMapConfig
- New-AzureRmApplicationGatewayBackendAddressPool
- New-AzureRmApplicationGatewayBackendHttpSettings
- New-AzureRmApplicationGatewayPathRuleConfig
- New-AzureRmApplicationGatewayUrlPathMapConfig
- Remove-AzureRmApplicationGatewayUrlPathMapConfig
- Set-AzureRmApplicationGatewayUrlPathMapConfig