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


Add-AzureRmNetworkSecurityRuleConfig

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

Предупреждение

Модуль AzureRM PowerShell официально устарел с 29 февраля 2024 г. Пользователям рекомендуется выполнить миграцию из AzureRM в модуль Az PowerShell, чтобы обеспечить постоянную поддержку и обновления.

Хотя модуль AzureRM по-прежнему может функционировать, он больше не поддерживается или не поддерживается, размещая любое постоянное использование на усмотрение и риск пользователя. Ознакомьтесь с нашими ресурсами миграции, чтобы получить рекомендации по переходу в модуль Az.

Синтаксис

Add-AzureRmNetworkSecurityRuleConfig
   -Name <String>
   -NetworkSecurityGroup <PSNetworkSecurityGroup>
   [-Description <String>]
   [-Protocol <String>]
   [-SourcePortRange <System.Collections.Generic.List`1[System.String]>]
   [-DestinationPortRange <System.Collections.Generic.List`1[System.String]>]
   [-SourceAddressPrefix <System.Collections.Generic.List`1[System.String]>]
   [-DestinationAddressPrefix <System.Collections.Generic.List`1[System.String]>]
   [-SourceApplicationSecurityGroup <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSApplicationSecurityGroup]>]
   [-DestinationApplicationSecurityGroup <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSApplicationSecurityGroup]>]
   [-Access <String>]
   [-Priority <Int32>]
   [-Direction <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Add-AzureRmNetworkSecurityRuleConfig
   -Name <String>
   -NetworkSecurityGroup <PSNetworkSecurityGroup>
   [-Description <String>]
   [-Protocol <String>]
   [-SourcePortRange <System.Collections.Generic.List`1[System.String]>]
   [-DestinationPortRange <System.Collections.Generic.List`1[System.String]>]
   [-SourceAddressPrefix <System.Collections.Generic.List`1[System.String]>]
   [-DestinationAddressPrefix <System.Collections.Generic.List`1[System.String]>]
   [-SourceApplicationSecurityGroupId <System.Collections.Generic.List`1[System.String]>]
   [-DestinationApplicationSecurityGroupId <System.Collections.Generic.List`1[System.String]>]
   [-Access <String>]
   [-Priority <Int32>]
   [-Direction <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Описание

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

Примеры

1. Добавление группы безопасности сети

Get-AzureRmNetworkSecurityGroup -Name  nsg1 -ResourceGroupName rg1 | 
Add-AzureRmNetworkSecurityRuleConfig -Name rdp-rule -Description "Allow RDP" -Access 
    Allow -Protocol Tcp -Direction Inbound -Priority 100 -SourceAddressPrefix Internet 
    -SourcePortRange * -DestinationAddressPrefix * -DestinationPortRange 3389 | 
    Set-AzureRmNetworkSecurityGroup

Первая команда извлекает группу безопасности сети Azure с именем nsg1 из группы ресурсов "rg1". Вторая команда добавляет правило безопасности сети с именем rdp-rule, которое разрешает трафик из Интернета через порт 3389 к полученному объекту группы безопасности сети. Сохраняет измененную группу безопасности сети Azure.

2. Добавление нового правила безопасности с группами безопасности приложений

$srcAsg = New-AzureRmApplicationSecurityGroup -ResourceGroupName MyResourceGroup -Name srcAsg -Location "West US"
$destAsg = New-AzureRmApplicationSecurityGroup -ResourceGroupName MyResourceGroup -Name destAsg -Location "West US"

Get-AzureRmNetworkSecurityGroup -Name  nsg1 -ResourceGroupName rg1 |
Add-AzureRmNetworkSecurityRuleConfig -Name rdp-rule -Description "Allow RDP" -Access
    Allow -Protocol Tcp -Direction Inbound -Priority 100 -SourceApplicationSecurityGroup
    $srcAsg -SourcePortRange * -DestinationApplicationSecurityGroup $destAsg -DestinationPortRange 3389 |
Set-AzureRmNetworkSecurityGroup

Сначала мы создадим две новые группы безопасности приложений. Затем мы извлекаем группу безопасности сети Azure с именем nsg1 из группы ресурсов "rg1". и добавьте в него правило безопасности сети с именем rdp-rule. Правило разрешает трафик из всех IP-конфигураций в группе безопасности приложений srcAsg ко всем IP-конфигурациям в destAsg через порт 3389. После добавления правила мы сохраняем измененную группу безопасности сети Azure.

Параметры

-Access

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

Тип:String
допустимые значения:Allow, Deny
Position:Named
значение по умолчанию:None
Обязательно:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

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

Тип:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Position:Named
значение по умолчанию:None
Обязательно:False
Accept pipeline input:False
Accept wildcard characters:False

-Description

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

Тип:String
Position:Named
значение по умолчанию:None
Обязательно:False
Accept pipeline input:False
Accept wildcard characters:False

-DestinationAddressPrefix

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

  • Адрес CIDR (CIDR)
  • Диапазон IP-адресов назначения
  • Дикий карта символ (*) для сопоставления любого IP-адреса можно использовать теги, такие как VirtualNetwork, AzureLoadBalancer и Интернет.
Тип:List<T>[String]
Position:Named
значение по умолчанию:None
Обязательно:False
Accept pipeline input:False
Accept wildcard characters:False

-DestinationApplicationSecurityGroup

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

Тип:List<T>[PSApplicationSecurityGroup]
Position:Named
значение по умолчанию:None
Обязательно:False
Accept pipeline input:False
Accept wildcard characters:False

-DestinationApplicationSecurityGroupId

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

Тип:List<T>[String]
Position:Named
значение по умолчанию:None
Обязательно:False
Accept pipeline input:False
Accept wildcard characters:False

-DestinationPortRange

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

  • Целое число
  • Диапазон целых чисел от 0 до 65535
  • Дикий карта символ (*) для сопоставления любого порта
Тип:List<T>[String]
Position:Named
значение по умолчанию:None
Обязательно:False
Accept pipeline input:False
Accept wildcard characters:False

-Direction

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

Тип:String
допустимые значения:Inbound, Outbound
Position:Named
значение по умолчанию:None
Обязательно:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

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

Тип:String
Position:Named
значение по умолчанию:None
Обязательно:True
Accept pipeline input:False
Accept wildcard characters:False

-NetworkSecurityGroup

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

Тип:PSNetworkSecurityGroup
Position:Named
значение по умолчанию:None
Обязательно:True
Accept pipeline input:True
Accept wildcard characters:False

-Priority

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

Тип:Int32
Position:Named
значение по умолчанию:None
Обязательно:False
Accept pipeline input:False
Accept wildcard characters:False

-Protocol

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

  • TCP
  • Udp
  • Wild карта символ (*) для сопоставления обоих
Тип:String
допустимые значения:Tcp, Udp, *
Position:Named
значение по умолчанию:None
Обязательно:False
Accept pipeline input:False
Accept wildcard characters:False

-SourceAddressPrefix

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

  • A CIDR
  • Диапазон исходных IP-адресов
  • Дикий карта символ (*) для сопоставления любого IP-адреса. Вы также можете использовать теги, такие как VirtualNetwork, AzureLoadBalancer и Интернет.
Тип:List<T>[String]
Position:Named
значение по умолчанию:None
Обязательно:False
Accept pipeline input:False
Accept wildcard characters:False

-SourceApplicationSecurityGroup

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

Тип:List<T>[PSApplicationSecurityGroup]
Position:Named
значение по умолчанию:None
Обязательно:False
Accept pipeline input:False
Accept wildcard characters:False

-SourceApplicationSecurityGroupId

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

Тип:List<T>[String]
Position:Named
значение по умолчанию:None
Обязательно:False
Accept pipeline input:False
Accept wildcard characters:False

-SourcePortRange

Указывает исходный порт или диапазон. Это значение выражается как целое число, в диапазоне от 0 до 65535 или как дикий карта символ (*) для сопоставления любого исходного порта.

Тип:List<T>[String]
Position:Named
значение по умолчанию:None
Обязательно:False
Accept pipeline input:False
Accept wildcard characters:False

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

PSNetworkSecurityGroup

Параметры: NetworkSecurityGroup (ByValue)

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

PSNetworkSecurityGroup