Dela via

New-AzureRmApplicationGatewayPathRuleConfig

  • Referens
Modul:
AzureRM.Network

Skapar en sökvägsregel för application gateway.

Varning

AzureRM PowerShell-modulen är officiellt inaktuell från och med den 29 februari 2024. Användare rekommenderas att migrera från AzureRM till Az PowerShell-modulen för att säkerställa fortsatt support och uppdateringar.

Även om AzureRM-modulen fortfarande kan fungera, underhålls den inte längre eller stöds, vilket gör att användaren kan välja och riskera fortsatt användning. Se våra migreringsresurser för vägledning om övergången till Az-modulen.

Syntax

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

Cmdleten New-AzureRmApplicationGatewayPathRuleConfig skapar en sökvägsregel för programgateway. Regler som skapats av den här cmdleten kan läggas till i en samling konfigurationsinställningar för url-sökvägskarta och sedan tilldelas till en gateway. Konfigurationsinställningar för sökvägskarta används vid belastningsutjämning för application gateway.

Exempel

Exempel 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 $HttpSettings

Dessa kommandon skapar en ny sökvägsregel för application gateway och använder sedan cmdleten Add-AzureRmApplicationGatewayUrlPathMapConfig för att tilldela den regeln till en programgateway. För att göra detta skapar det första kommandot en objektreferens till gatewayen ContosoApplicationGateway. Den här objektreferensen lagras i en variabel med namnet $Gateway. De följande två kommandona skapar en serverdelsadresspool och ett HTTP-inställningsobjekt för serverdelen. dessa objekt (som lagras i variablerna $AddressPool och $Http Inställningar) behövs för att skapa ett sökvägsregelobjekt. Det fjärde kommandot skapar sökvägsregelobjektet och lagras i en variabel med namnet $PathRuleConfig. Det femte kommandot använder Add-AzureRmApplicationGatewayUrlPathMapConfig för att lägga till konfigurationsinställningarna och den nya sökvägsregeln i dessa inställningar till ContosoApplicationGateway.

Parametrar

-BackendAddressPool

Anger en objektreferens till en samling inställningar för serverdelsadresspoolen som ska läggas till i konfigurationsinställningarna för gatewaysökvägsregler. Du kan skapa den här objektreferensen med hjälp av cmdleten New-AzureRmApplicationGatewayBackendAddressPool och syntax som liknar följande: $AddressPool = New-AzureRmApplicationGatewayBackendAddressPool -Name "ContosoAddressPool" -BackendIPAddresses "192.168.1.1", "192.168.1.2" Föregående kommando lägger till två IP-adresser (192.16.1.1 och 192.168.1.2) till adresspoolen. Observera att IP-adressen omges av citattecken och avgränsas med kommatecken. Den resulterande variabeln $AddressPool kan sedan användas som parametervärde för parametern DefaultBackendAddressPool . Serverdelsadresspoolen representerar IP-adresserna på serverdelsservrarna. Dessa IP-adresser ska antingen tillhöra undernätet för det virtuella nätverket eller vara offentliga IP-adresser. Om du använder den här parametern kan du inte använda parametern DefaultBackendAddressPoolId i samma kommando.

Typ:PSApplicationGatewayBackendAddressPool
Position:Named
standardvärde:None
Obligatorisk:False
Accept pipeline input:False
Accept wildcard characters:False

-BackendAddressPoolId

Anger ID för en befintlig serverdelsadresspool som kan läggas till i konfigurationsinställningarna för gatewaysökvägsregeln. Adresspools-ID:t kan returneras med hjälp av cmdleten Get-AzureRmApplicationGatewayBackendAddressPool. När du har ID:t kan du sedan använda parametern DefaultBackendAddressPoolId i stället för parametern DefaultBackendAddressPool . Till exempel: -DefaultBackendAddressPoolId "/subscriptions/39c54063-01d3-4abf-8f4c-234777bc1f10/resourceGroups/appgw-rg/providers/Microsoft.Network/applicationGateways/appgwtest/backendAddressPools/ContosoAddressPool" Serverdelsadresspoolen representerar IP-adresserna på serverdelsservrarna. Dessa IP-adresser ska antingen tillhöra undernätet för det virtuella nätverket eller vara offentliga IP-adresser.

Typ:String
Position:Named
standardvärde:None
Obligatorisk:False
Accept pipeline input:False
Accept wildcard characters:False

-BackendHttpSettings

Anger en objektreferens till en samling HTTP-inställningar för serverdelen som ska läggas till i konfigurationsinställningarna för gatewaysökvägsregeln. Du kan skapa den här objektreferensen med hjälp av cmdleten New-AzureRmApplicationGatewayBackendHttp Inställningar och syntax som liknar följande: $Http Inställningar = New-AzureRmApplicationGatewayBackendHttp Inställningar -Name "ContosoHttpSetings" -Port 80 -Protocol "Http" -CookieBasedAffinity "Disabled" Den resulterande variabeln $Http Inställningarkan sedan användas som parametervärde för parametern DefaultBackendAddressPool: -DefaultBackendHttp Inställningar $Http Inställningar Http-inställningarna för serverdelen konfigurerar egenskaper som port, protokoll och cookiebaserad tillhörighet för en serverdelspool. Om du använder den här parametern kan du inte använda parametern DefaultBackendHttp Inställningar Id i samma kommando.

Typ:PSApplicationGatewayBackendHttpSettings
Position:Named
standardvärde:None
Obligatorisk:False
Accept pipeline input:False
Accept wildcard characters:False

-BackendHttpSettingsId

Anger ID:t för en befintlig HTTP-inställningssamling för serverdelen som kan läggas till i konfigurationsinställningarna för gatewaysökvägsregeln. HTTP-inställnings-ID:er kan returneras med hjälp av cmdleten Get-AzureRmApplicationGatewayBackendHttp Inställningar. När du har ID:t kan du sedan använda parametern DefaultBackendHttp Inställningar Id i stället för parametern DefaultBackendHttp Inställningar. Till exempel: -DefaultBackend Inställningar ID "/subscriptions/39c54063-01d3-4abf-8f4c-234777bc1f10/resourceGroups/appgw-rg/providers/Microsoft.Network/applicationGateways/appgwtest/backendHttp Inställningar Collection/ContosoHttp Inställningar" Http-inställningarna för serverdelen konfigurerar egenskaper som port, protokoll, och cookiebaserad tillhörighet för en serverdelspool. Om du använder den här parametern kan du inte använda parametern DefaultBackendHttp Inställningar i samma kommando.

Typ:String
Position:Named
standardvärde:None
Obligatorisk:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

Autentiseringsuppgifter, konto, klientorganisation och prenumeration som används för kommunikation med Azure.

Typ:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Position:Named
standardvärde:None
Obligatorisk:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

Anger namnet på den konfiguration av sökvägsregeln som den här cmdleten skapar.

Typ:String
Position:Named
standardvärde:None
Obligatorisk:True
Accept pipeline input:False
Accept wildcard characters:False

-Paths

Anger en eller flera sökvägsregler för programgatewayen.

Typ:List<T>[String]
Position:Named
standardvärde:None
Obligatorisk:True
Accept pipeline input:False
Accept wildcard characters:False

-RedirectConfiguration

Omdirigering av ProgramgatewayKonfiguration

Typ:PSApplicationGatewayRedirectConfiguration
Position:Named
standardvärde:None
Obligatorisk:False
Accept pipeline input:False
Accept wildcard characters:False

-RedirectConfigurationId

ID för programgatewayen RedirectConfiguration

Typ:String
Position:Named
standardvärde:None
Obligatorisk:False
Accept pipeline input:False
Accept wildcard characters:False

Indata

None

Utdata

PSApplicationGatewayPathRule