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


Set-AzNetworkSecurityRuleConfig

Обновляет конфигурацию правила безопасности сети для группы безопасности сети.

Синтаксис

Set-AzNetworkSecurityRuleConfig
   -Name <String>
   -NetworkSecurityGroup <PSNetworkSecurityGroup>
   [-Description <String>]
   [-Protocol <String>]
   [-SourcePortRange <String[]>]
   [-DestinationPortRange <String[]>]
   [-SourceAddressPrefix <String[]>]
   [-DestinationAddressPrefix <String[]>]
   [-SourceApplicationSecurityGroup <PSApplicationSecurityGroup[]>]
   [-DestinationApplicationSecurityGroup <PSApplicationSecurityGroup[]>]
   [-Access <String>]
   [-Priority <Int32>]
   [-Direction <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Set-AzNetworkSecurityRuleConfig
   -Name <String>
   -NetworkSecurityGroup <PSNetworkSecurityGroup>
   [-Description <String>]
   [-Protocol <String>]
   [-SourcePortRange <String[]>]
   [-DestinationPortRange <String[]>]
   [-SourceAddressPrefix <String[]>]
   [-DestinationAddressPrefix <String[]>]
   [-SourceApplicationSecurityGroupId <String[]>]
   [-DestinationApplicationSecurityGroupId <String[]>]
   [-Access <String>]
   [-Priority <Int32>]
   [-Direction <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Описание

Командлет Set-AzNetworkSecurityRuleConfig обновляет конфигурацию правила безопасности сети для группы безопасности сети.

Примеры

Пример 1. Изменение конфигурации доступа в правиле безопасности сети

$nsg = Get-AzNetworkSecurityGroup -Name "NSG-FrontEnd" -ResourceGroupName "TestRG"
$nsg | Get-AzNetworkSecurityRuleConfig -Name "rdp-rule"
Set-AzNetworkSecurityRuleConfig -Name "rdp-rule" -NetworkSecurityGroup $nsg -Access "Deny"

Первая команда получает группу безопасности сети с именем NSG-FrontEnd, а затем сохраняет ее в переменной $nsg. Вторая команда использует оператор конвейера для передачи группы безопасности в $nsg Get-AzNetworkSecurityRuleConfig, которая получает конфигурацию правила безопасности с именем rdp-rule. Третья команда изменяет конфигурацию доступа правила rdp-rule на Deny. Однако это перезаписывает правило и задает только параметры, передаваемые функции Set-AzNetworkSecurityRuleConfig. ПРИМЕЧАНИЕ. Изменение одного атрибута невозможно.

Пример 2

Обновляет конфигурацию правила безопасности сети для группы безопасности сети. (автоматическое создание)

Set-AzNetworkSecurityRuleConfig -Access Allow -DestinationAddressPrefix * -DestinationPortRange 3389 -Direction Inbound -Name 'rdp-rule' -NetworkSecurityGroup <PSNetworkSecurityGroup> -Priority 1 -Protocol Tcp -SourceAddressPrefix 'Internet' -SourcePortRange *

Пример 3

Обновляет конфигурацию правила безопасности сети для группы безопасности сети. (автоматическое создание)

Set-AzNetworkSecurityRuleConfig -Access Allow -Description 'Allow RDP' -DestinationAddressPrefix * -DestinationPortRange 3389 -Direction Inbound -Name 'rdp-rule' -NetworkSecurityGroup <PSNetworkSecurityGroup> -Priority 1 -Protocol Tcp -SourceAddressPrefix 'Internet' -SourcePortRange *

Пример 4

Обновляет конфигурацию правила безопасности сети для группы безопасности сети (исходный IP-адрес)

$nsg = Get-AzNetworkSecurityGroup -ResourceGroupName "MyResource" -Name "MyNsg"
($nsg.SecurityRules | Where-Object {$_.Name -eq "RuleName"}).SourceAddressPrefix = ([System.String[]] @("xxx.xxx.xxx.xxx"))
$nsg | Set-AzNetworkSecurityGroup | Get-AzNetworkSecurityRuleConfig -Name "RuleName"

Параметры

-Access

Указывает, разрешен или запрещен сетевой трафик. Допустимые значения для этого параметра: allow and Deny.

Тип:String
Допустимые значения:Allow, Deny
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-DefaultProfile

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

Тип:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Description

Указывает описание конфигурации правила. Максимальный размер — 140 символов.

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-DestinationAddressPrefix

Задает префикс адреса назначения. Допустимые значения для этого параметра:

  • Адрес CIDR (CIDR)
  • Диапазон IP-адресов назначения
  • Подстановочный знак (*) для сопоставления любого IP-адреса. Вы можете использовать такие теги, как VirtualNetwork, AzureLoadBalancer и Интернет.
Тип:String[]
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-DestinationApplicationSecurityGroup

Группа безопасности приложений, заданная в качестве назначения для правила. Его нельзя использовать с параметром DestinationAddressPrefix.

Тип:PSApplicationSecurityGroup[]
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-DestinationApplicationSecurityGroupId

Группа безопасности приложений, заданная в качестве назначения для правила. Его нельзя использовать с параметром DestinationAddressPrefix.

Тип:String[]
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-DestinationPortRange

Указывает порт назначения или диапазон. Допустимые значения для этого параметра:

  • Целое число
  • Диапазон целых чисел от 0 до 65535
  • Подстановочный знак (*) для сопоставления любого порта
Тип:String[]
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Direction

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

Тип:String
Допустимые значения:Inbound, Outbound
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Name

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

Тип:String
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-NetworkSecurityGroup

Указывает объект NetworkSecurityGroup , содержащий конфигурацию правила безопасности сети, которую необходимо задать.

Тип:PSNetworkSecurityGroup
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-Priority

Указывает приоритет конфигурации правила. Допустимые значения для этого параметра: целое число от 100 до 4096. Номер приоритета должен быть уникальным для каждого правила в коллекции. Чем ниже номер приоритета, тем выше приоритет правила.

Тип:Int32
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Protocol

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

  • TCP
  • Udp
  • Icmp
  • Esp
  • Подстановочный знак (*) для соответствия всем
Тип:String
Допустимые значения:Tcp, Udp, Icmp, Esp, Ah, *
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-SourceAddressPrefix

Задает префикс исходного адреса. Допустимые значения для этого параметра:

  • A CIDR
  • Диапазон исходных IP-адресов
  • Подстановочный знак (*) для сопоставления любого IP-адреса. Вы также можете использовать теги, такие как VirtualNetwork, AzureLoadBalancer и Интернет.
Тип:String[]
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-SourceApplicationSecurityGroup

Группа безопасности приложений, заданная в качестве источника для правила. Его нельзя использовать с параметром SourceAddressPrefix.

Тип:PSApplicationSecurityGroup[]
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-SourceApplicationSecurityGroupId

Группа безопасности приложений, заданная в качестве источника для правила. Его нельзя использовать с параметром SourceAddressPrefix.

Тип:String[]
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-SourcePortRange

Указывает исходный порт или диапазон. Допустимые значения для этого параметра:

  • Целое число
  • Диапазон целых чисел от 0 до 65535
  • Подстановочный знак (*) для сопоставления любого порта
Тип:String[]
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

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

PSNetworkSecurityGroup

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

PSNetworkSecurityGroup