New-AzureRmApplicationGatewayPathRuleConfig

  • Referenz
Modul:
AzureRM.Network

Erstellt eine Anwendungsgatewaypfadregel.

Warnung

Das AzureRM PowerShell-Modul ist seit dem 29. Februar 2024 offiziell veraltet. Benutzern wird empfohlen, von AzureRM zum Az PowerShell-Modul zu migrieren, um weiterhin Support und Updates zu erhalten.

Obwohl das AzureRM-Modul weiterhin funktioniert, wird es nicht mehr Standard tained oder unterstützt, wobei eine fortgesetzte Verwendung nach Ermessen und Risiko des Benutzers erfolgt. Weitere Informationen zum Übergang zum Az-Modul finden Sie in unseren Migrationsressourcen.

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

Beschreibung

Das Cmdlet New-AzureRmApplicationGatewayPathRuleConfig erstellt eine Pfadregel für das Anwendungsgateway. Von diesem Cmdlet erstellte Regeln können einer Sammlung von Konfigurationseinstellungen für die URL-Pfadzuordnung hinzugefügt und dann einem Gateway zugewiesen werden. Pfadzuordnungskonfigurationseinstellungen werden im Lastenausgleich des Anwendungsgateways verwendet.

Beispiele

Beispiel 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

Diese Befehle erstellen eine neue Anwendungsgatewaypfadregel und verwenden dann das Cmdlet "Add-AzureRmApplicationGatewayUrlPathMapConfig ", um diese Regel einem Anwendungsgateway zuzuweisen. Dazu erstellt der erste Befehl einen Objektverweis auf das Gateway ContosoApplicationGateway. Dieser Objektverweis wird in einer Variablen namens $Gateway gespeichert. Die nächsten beiden Befehle erstellen einen Back-End-Adresspool und ein Back-End-HTTP-Einstellungsobjekt; Diese Objekte (die in den Variablen $AddressPool und $Http Einstellungen gespeichert sind) sind erforderlich, um ein Pfadregelobjekt zu erstellen. Der vierte Befehl erstellt das Pfadregelobjekt und wird in einer Variablen namens $PathRuleConfig gespeichert. Der fünfte Befehl verwendet Add-AzureRmApplicationGatewayUrlPathMapConfig , um die Konfigurationseinstellungen und die neue Pfadregel in diesen Einstellungen zu ContosoApplicationGateway hinzuzufügen.

Parameter

-BackendAddressPool

Gibt einen Objektverweis auf eine Auflistung von Back-End-Adresspooleinstellungen an, die den Konfigurationseinstellungen für Gatewaypfadregeln hinzugefügt werden sollen. Sie können diesen Objektverweis mithilfe des Cmdlets New-AzureRmApplicationGatewayBackendAddressPool und ähnlich der folgenden Syntax erstellen: $AddressPool = New-AzureRmApplicationGatewayBackendAddressPool -Name "ContosoAddressPool" -BackendIPAddresses "192.168.1.1", "192.168.1.2" Mit dem vorherigen Befehl werden dem Adresspool zwei IP-Adressen (192.16.1.1 und 192.168.1.2) hinzugefügt. Beachten Sie, dass die IP-Adresse in Anführungszeichen gesetzt und durch Kommas getrennt wird. Die resultierende Variable $AddressPool kann dann als Parameterwert für den Parameter DefaultBackendAddressPool verwendet werden. Der Back-End-Adresspool stellt die IP-Adressen auf den Back-End-Servern dar. Diese IP-Adressen sollten entweder zum subnetz des virtuellen Netzwerks gehören oder öffentliche IP-Adressen sein. Wenn Sie diesen Parameter verwenden, können Sie den Parameter DefaultBackendAddressPoolId nicht im selben Befehl verwenden.

Type:PSApplicationGatewayBackendAddressPool
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-BackendAddressPoolId

Gibt die ID eines vorhandenen Back-End-Adresspools an, der den Konfigurationseinstellungen der Gatewaypfadregel hinzugefügt werden kann. Adresspool-IDs können mithilfe des Cmdlets "Get-AzureRmApplicationGatewayBackendAddressPool" zurückgegeben werden. Nachdem Sie über die ID verfügen, können Sie den Parameter DefaultBackendAddressPoolId anstelle des Parameters DefaultBackendAddressPool verwenden. Beispiel: -DefaultBackendAddressPoolId "/subscriptions/39c54063-01d3-4abf-8f4c-234777bc1f10/resourceGroups/appgw-rg/providers/Microsoft.Network/applicationGateways/appgwtest/backendAddressPools/ContosoAddressPool" Der Back-End-Adresspool stellt die IP-Adressen auf den Back-End-Servern dar. Diese IP-Adressen sollten entweder zum subnetz des virtuellen Netzwerks gehören oder öffentliche IP-Adressen sein.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-BackendHttpSettings

Gibt einen Objektverweis auf eine Auflistung von BACK-End-HTTP-Einstellungen an, die den Konfigurationseinstellungen für Gatewaypfadregel hinzugefügt werden sollen. Sie können diesen Objektverweis mithilfe des Cmdlets New-AzureRmApplicationGatewayBackendHttp Einstellungen und der folgenden Syntax erstellen: $Http Einstellungen = New-AzureRmApplicationGatewayBackendHttp Einstellungen -Name "ContosoHttpSetings" -Port 80 -Protocol "Http" -CookieBasedAffinity "Disabled" Die resultierende Variable, $Http Einstellungenkann dann als Parameterwert für den Parameter DefaultBackendAddressPool verwendet werden: -DefaultBackendHttp Einstellungen $Http Einstellungen Die Back-End-HTTP-Einstellungen konfigurieren Eigenschaften wie Port, Protokoll und cookiebasierte Affinität für einen Back-End-Pool. Wenn Sie diesen Parameter verwenden, können Sie den Parameter DefaultBackendHttp Einstellungen Id nicht im selben Befehl verwenden.

Type:PSApplicationGatewayBackendHttpSettings
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-BackendHttpSettingsId

Gibt die ID einer vorhandenen Back-End-HTTP-Einstellungsauflistung an, die den Konfigurationseinstellungen für Gatewaypfadregel hinzugefügt werden kann. HTTP-Einstellungs-IDs können mithilfe des Cmdlets Get-AzureRmApplicationGatewayBackendHttp Einstellungen zurückgegeben werden. Nachdem Sie über die ID verfügen, können Sie den Parameter DefaultBackendHttp Einstellungen Id anstelle des Parameters DefaultBackendHttp Einstellungen verwenden. Beispiel: -DefaultBackend Einstellungen ID "/subscriptions/39c54063-01d3-4abf-8f4c-234777bc1f10/resourceGroups/appgw-rg/providers/Microsoft.Network/applicationGateways/appgwtest/backendHttp Einstellungen Collection/ContosoHttp Einstellungen" Die Back-End-HTTP-Einstellungen konfigurieren Eigenschaften wie Port, Protokoll und cookiebasierte Affinität für einen Back-End-Pool. Wenn Sie diesen Parameter verwenden, können Sie den Parameter DefaultBackendHttp Einstellungen nicht im selben Befehl verwenden.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

Die Anmeldeinformationen, Konten, Mandanten und Abonnements, die für die Kommunikation mit Azure verwendet werden.

Type:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

Gibt den Namen der Pfadregelkonfiguration an, die dieses Cmdlet erstellt.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Paths

Gibt eine oder mehrere Anwendungsgatewaypfadregeln an.

Type:List<T>[String]
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-RedirectConfiguration

Application gateway RedirectConfiguration

Type:PSApplicationGatewayRedirectConfiguration
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RedirectConfigurationId

ID des Anwendungsgateways RedirectConfiguration

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Eingaben

None

Ausgaben

PSApplicationGatewayPathRule