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 |