New-AzFirewallApplicationRuleCollection

Модуль:
Az.Network Module

Создает коллекцию правил приложения брандмауэра.

Синтаксис

Default (По умолчанию) 

New-AzFirewallApplicationRuleCollection
    -Name <String>
    -Priority <UInt32>
    -Rule <PSAzureFirewallApplicationRule[]>
    -ActionType <String>
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [-AcquirePolicyToken]
    [-ChangeReference <String>]
    [<CommonParameters>]

Описание

Командлет New-AzFirewallApplicationRuleCollection создает коллекцию правил приложений брандмауэра.

Примеры

Пример 1. Создание коллекции с одним правилом

$rule1 = New-AzFirewallApplicationRule -Name "httpsRule" -Protocol "https:443" -TargetFqdn "*" -SourceAddress "10.0.0.0"
New-AzFirewallApplicationRuleCollection -Name "MyAppRuleCollection" -Priority 1000 -Rule $rule1 -ActionType "Allow"

В этом примере создается коллекция с одним правилом. Будет разрешен весь трафик, соответствующий условиям, указанным в $rule 1. Первое правило — для всего трафика HTTPS через порт 443 от 10.0.0.0.0. Если имеется другая коллекция правил приложения с более высоким приоритетом (меньшее число), которая также соответствует трафику, определенному в $rule 1, действие коллекции правил с более высоким приоритетом будет применяться вместо этого.

Пример 2. Добавление правила в коллекцию правил

$rule1 = New-AzFirewallApplicationRule -Name R1 -Protocol "http:80","https:443" -TargetFqdn "*google.com", "*microsoft.com" -SourceAddress "10.0.0.0"
$ruleCollection = New-AzFirewallApplicationRuleCollection -Name "MyAppRuleCollection" -Priority 100 -Rule $rule1 -ActionType "Allow"

$rule2 = New-AzFirewallApplicationRule -Name R2 -Protocol "http:80","https:443" -TargetFqdn "*google.com", "*microsoft.com"
$ruleCollection.AddRule($rule2)

В этом примере создается новая коллекция правил приложения с одним правилом, а затем в коллекцию правил добавляется второе правило с помощью метода AddRule в объекте коллекции правил. Каждое имя правила в данной коллекции правил должно иметь уникальное имя и не учитывает регистр.

Пример 3. Получение правила из коллекции правил

$rule1 = New-AzFirewallApplicationRule -Name R1 -Protocol "http:80","https:443" -TargetFqdn "*google.com", "*microsoft.com" -SourceAddress "10.0.0.0"
$ruleCollection = New-AzFirewallApplicationRuleCollection -Name "MyAppRuleCollection" -Priority 100 -Rule $rule1 -ActionType "Allow"
$getRule=$ruleCollection.GetRuleByName("r1")

В этом примере создается новая коллекция правил приложения с одним правилом, а затем получает правило по имени, вызывая метод GetRuleByName в объекте коллекции правил. Имя правила метода GetRuleByName не учитывает регистр.

Пример 4. Удаление правила из коллекции правил

$rule1 = New-AzFirewallApplicationRule -Name R1 -Protocol "http:80","https:443" -TargetFqdn "*google.com", "*microsoft.com" -SourceAddress "10.0.0.0"
$rule2 = New-AzFirewallApplicationRule -Name R2 -Protocol "http:80","https:443" -TargetFqdn "*google.com", "*microsoft.com"
$ruleCollection = New-AzFirewallApplicationRuleCollection -Name "MyAppRuleCollection" -Priority 100 -Rule $rule1, $rule1 -ActionType "Allow"
$ruleCollection.RemoveRuleByName("r1")

В этом примере создается новая коллекция правил приложения с двумя правилами, а затем удаляет первое правило из коллекции правил путем вызова метода RemoveRuleByName в объекте коллекции правил. Имя правила для метода RemoveRuleByName не учитывает регистр.

Параметры

-AcquirePolicyToken

Автоматическое получение маркера Политика Azure для этой операции ресурса.

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

Тип:SwitchParameter
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

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

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

-ActionType

Действие коллекции правил

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

Тип:String
Значение по умолчанию:None
Допустимые значения:Allow, Deny
Поддерживаются подстановочные знаки:False
DontShow:False

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

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

-ChangeReference

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

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

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

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

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

-Confirm

Запрашивает подтверждение перед запуском cmdlet.

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

Тип:SwitchParameter
Значение по умолчанию:False
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:Cf

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

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

-DefaultProfile

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

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

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

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

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

-Name

Указывает имя этого правила приложения. Имя должно быть уникальным внутри коллекции правил.

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

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

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

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

-Priority

Указывает приоритет этого правила. Приоритет — это число от 100 до 65000. Чем меньше число, тем больше приоритет.

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

Тип:UInt32
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

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

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

-Rule

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

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

Тип:

PSAzureFirewallApplicationRule[]

Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

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

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

-WhatIf

Показывает, что произойдет, если командлет будет запущен. Командлет не запускается.

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

Тип:SwitchParameter
Значение по умолчанию:False
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:Wi

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

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

CommonParameters

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

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

None

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

PSAzureFirewallApplicationRuleCollection