Поделиться через

New-AzApplicationGatewayPathRuleConfig

Модуль:
Az.Network Module

Создает правило пути шлюза приложений.

Синтаксис

SetByResourceId 

New-AzApplicationGatewayPathRuleConfig
    -Name <String>
    -Paths <String[]>
    [-BackendAddressPoolId <String>]
    [-BackendHttpSettingsId <String>]
    [-RewriteRuleSetId <String>]
    [-RedirectConfigurationId <String>]
    [-FirewallPolicyId <String>]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

SetByResource 

New-AzApplicationGatewayPathRuleConfig
    -Name <String>
    -Paths <String[]>
    [-BackendAddressPool <PSApplicationGatewayBackendAddressPool>]
    [-BackendHttpSettings <PSApplicationGatewayBackendHttpSettings>]
    [-RewriteRuleSet <PSApplicationGatewayRewriteRuleSet>]
    [-RedirectConfiguration <PSApplicationGatewayRedirectConfiguration>]
    [-FirewallPolicy <PSApplicationGatewayWebApplicationFirewallPolicy>]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

Описание

Командлет New-AzApplicationGatewayPathRuleConfig создает правило пути шлюза приложений. Правила, созданные этим командлетом, можно добавить в коллекцию параметров конфигурации карты URL-пути, а затем назначить шлюзу. Параметры конфигурации карты пути используются в балансировке нагрузки шлюза приложений.

Примеры

Пример 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

Эти команды создают новое правило пути шлюза приложений, а затем используйте командлет Add-AzApplicationGatewayUrlPathMapConfig , чтобы назначить это правило шлюзу приложений. Для этого первая команда создает ссылку на объект шлюза ContosoApplicationGateway. Эта ссылка на объект хранится в переменной с именем $Gateway. Следующие две команды создают внутренний пул адресов и объект параметров HTTP серверной части; эти объекты (хранящиеся в переменных $AddressPool и $HttpSettings) необходимы для создания объекта правила пути. Четвертая команда создает объект правила пути и хранится в переменной с именем $PathRuleConfig. Пятая команда использует Add-AzApplicationGatewayUrlPathMapConfig для добавления параметров конфигурации и нового правила пути, содержащегося в этих параметрах в ContosoApplicationGateway.

Пример 2

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

Эта команда создает правило пути с именем как "base", Paths as "/base", BackendAddressPool как $AddressPool, BackendHttpSettings как $HttpSettings и FirewallPolicy как $firewallPolicy.ngs и новое правило пути, содержащееся в этих параметрах в ContosoApplicationGateway.

Параметры

-BackendAddressPool

Указывает ссылку на объект в коллекцию параметров внутреннего пула адресов, которые необходимо добавить в параметры конфигурации правил пути шлюза. Вы можете создать эту ссылку на объект с помощью командлета New-AzApplicationGatewayBackendAddressPool и синтаксиса, аналогичного следующему: $AddressPool = New-AzApplicationGatewayBackendAddressPool -Name "ContosoAddressPool" -BackendIPAddresses "192.168.1.1", "192.168.1.2" Предыдущая команда добавляет два IP-адреса (192.16.1.1 и 192.168.1.2) в пул адресов. Обратите внимание, что IP-адрес заключен в кавычки и разделен запятыми. Результирующая переменная, $AddressPool, затем может использоваться в качестве значения параметра DefaultBackendAddressPool . Пул внутренних адресов представляет IP-адреса на внутренних серверах. Эти IP-адреса должны принадлежать подсети виртуальной сети или должны быть общедоступными IP-адресами. Если этот параметр используется, параметр DefaultBackendAddressPoolId нельзя использовать в той же команде.

Свойства параметра

Тип:PSApplicationGatewayBackendAddressPool
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

SetByResource
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-BackendAddressPoolId

Указывает идентификатор существующего пула внутренних адресов, который можно добавить в параметры конфигурации правила пути шлюза. Идентификаторы пула адресов можно вернуть с помощью командлета Get-AzApplicationGatewayBackendAddressPool. После того как у вас есть идентификатор, можно использовать параметр DefaultBackendAddressPoolId вместо параметра DefaultBackendAddressPool . Например: -DefaultBackendAddressPoolId "/subscriptions/39c54063-01d3-4abf-8f4c-234777bc1f1f10/resourceGroups/appgw-rg/providers/Microsoft.Network/applicationGateways/appgwtest/backendAddressPools/ContosoAddressPool" Серверный пул адресов представляет IP-адреса на внутренних серверах. Эти IP-адреса должны принадлежать подсети виртуальной сети или должны быть общедоступными IP-адресами.

Свойства параметра

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

SetByResourceId
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-BackendHttpSettings

Указывает ссылку на объект в коллекцию внутренних параметров HTTP, добавляемых в параметры конфигурации правила пути шлюза. Эту ссылку на объект можно создать с помощью командлета New-AzApplicationGatewayBackendHttpSettings и синтаксиса, аналогичного этому: $HttpSettings = New-AzApplicationGatewayBackendHttpSettings -Name "ContosoHttpSettings" -Port 80 -Protocol "Http" -CookieBasedAffinity "Disabled" Результирующей переменной, $HttpSettings затем можно использовать в качестве значения параметра для DefaultBackendAddressPool параметр: -DefaultBackendHttpSettings $HttpSettings Параметры HTTP серверной части настраивают такие свойства, как порт, протокол и сходство на основе файлов cookie для внутреннего пула. Если этот параметр используется, параметр DefaultBackendHttpSettingsId нельзя использовать в той же команде.

Свойства параметра

Тип:PSApplicationGatewayBackendHttpSettings
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

SetByResource
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-BackendHttpSettingsId

Указывает идентификатор существующей коллекции параметров HTTP серверной части, которую можно добавить в параметры конфигурации правила пути шлюза. Идентификаторы параметров HTTP можно вернуть с помощью командлета Get-AzApplicationGatewayBackendHttpSettings. После создания идентификатора можно использовать параметр DefaultBackendHttpSettingsId вместо параметра DefaultBackendHttpSettings . Например: -DefaultBackendSettings Id "/subscriptions/39c54063-01d3-4abf-8f4c-234777bc1f10/resourceGroups/appgw-rg/providers/Microsoft.Network/applicationGateways/appgwtest/backendHttpSettingsCollection/ContosoHttpSettings" Серверные параметры HTTP настраивают такие свойства, как порт, протокол, сходство на основе файлов cookie для внутреннего пула. Если этот параметр используется, параметр DefaultBackendHttpSettings нельзя использовать в той же команде.

Свойства параметра

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

SetByResourceId
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-DefaultProfile

Учетные данные, учетная запись, клиент и подписка, используемые для обмена данными с Azure.

Свойства параметра

Тип:IAzureContextContainer
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:AzContext, AzureRmContext, AzureCredential

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-FirewallPolicy

Указывает ссылку на объект для политики брандмауэра верхнего уровня. Ссылку на объект можно создать с помощью командлета New-AzApplicationGatewayWebApplicationFirewallPolicy. $firewallPolicy = New-AzApplicationGatewayFirewallPolicy -Name wafPolicy1 -ResourceGroup "rgName" Политика брандмауэра, созданная с помощью приведенного выше командлета, можно ссылаться на уровне правила пути. В приведенной выше команде будут созданы параметры политики по умолчанию и управляемые правила. Вместо значений по умолчанию пользователи могут указывать PolicySettings, ManagedRules с помощью New-AzApplicationGatewayFirewallPolicySettings и New-AzApplicationGatewayFirewallPolicyManagedRules соответственно.

Свойства параметра

Тип:PSApplicationGatewayWebApplicationFirewallPolicy
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

SetByResource
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-FirewallPolicyId

Указывает идентификатор существующего ресурса брандмауэра веб-приложения верхнего уровня. Идентификаторы политик брандмауэра можно возвращать с помощью командлета Get-AzApplicationGatewayWebApplicationFirewallPolicy. После того как у нас есть идентификатор, можно использовать параметр FirewallPolicyId вместо параметра FirewallPolicy. Например: -FirewallPolicyId /subscriptions/<subscription-id>/resourceGroups/<resource-group-id>/providers/Microsoft.Network/ApplicationGatewayWebApplicationFirewallPolicies/<firewallPolicyName>

Свойства параметра

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

SetByResourceId
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Name

Указывает имя конфигурации правила пути, создаваемой этим командлетом.

Свойства параметра

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Paths

Задает одно или несколько правил пути шлюза приложений.

Свойства параметра

Тип:

String[]

Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-RedirectConfiguration

Перенаправление шлюза приложений

Свойства параметра

Тип:PSApplicationGatewayRedirectConfiguration
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

SetByResource
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-RedirectConfigurationId

Идентификатор перенаправления шлюза приложений

Свойства параметра

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

SetByResourceId
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-RewriteRuleSet

ПерезаписьRuleSet шлюза приложений

Свойства параметра

Тип:PSApplicationGatewayRewriteRuleSet
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

SetByResource
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-RewriteRuleSetId

Идентификатор шлюза приложений RewriteRuleSet

Свойства параметра

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

SetByResourceId
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

CommonParameters

Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters.

Входные данные

None

Выходные данные

PSApplicationGatewayPathRule