Add-AzNetworkSecurityRuleConfig

  • 參考
模組:
Az.Network

將網路安全性規則設定新增到網路安全性群組中。

Syntax

Add-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>]
Add-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>]

Description

Add-AzNetworkSecurityRuleConfig Cmdlet 會將網路安全規則設定新增至 Azure 網路安全組。

範例

範例 1：新增網路安全組

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

第一個命令會從資源群組 「rg1」 擷取名為 「nsg1」 的 Azure 網路安全組。 第二個命令會新增名為 「rdp-rule」 的網路安全性規則，允許從埠 3389 上的因特網流量流向擷取的網路安全組物件。 保存修改過的 Azure 網路安全組。

範例 2：使用應用程式安全組新增安全性規則

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

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

首先，我們會建立兩個新的應用程式安全組。 然後，我們會從資源群組 「rg1」 擷取名為 「nsg1」 的 Azure 網路安全組。 並將名為 「rdp-rule」 的網路安全性規則新增至其中。 此規則允許流量從應用程式安全組 「srcAsg」 中的所有 IP 組態流向埠 3389 上 “destAsg” 中的所有 IP 組態。 新增規則之後，我們會保存修改過的 Azure 網路安全組。

參數

-Access

指定是否允許或拒絕網路流量。 此參數可接受的值為：允許和拒絕。

Type:String
Accepted values:Allow, Deny
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

用於與 azure 通訊的認證、帳戶、租用戶和訂用帳戶。

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Description

指定網路安全性規則組態的描述。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DestinationAddressPrefix

指定目的地地址前綴。 此參數可接受的值為：

  • 無類別網域間路由選擇 （CIDR） 位址
  • 目的地IP位址範圍
  • 通配符 \ 以符合任何IP位址。 您可以使用 VirtualNetwork、AzureLoadBalancer 和因特網等標籤。
Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DestinationApplicationSecurityGroup

應用程式安全組設定為規則的目的地。 它不能與 『DestinationAddressPrefix』 參數搭配使用。

Type:PSApplicationSecurityGroup[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DestinationApplicationSecurityGroupId

應用程式安全組設定為規則的目的地。 它不能與 『DestinationAddressPrefix』 參數搭配使用。

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DestinationPortRange

指定目的地埠或範圍。 此參數可接受的值為：

  • 整數
  • 介於 0 到 65535 之間的整數範圍
  • 通配符 \ 以符合任何埠
Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Direction

指定在傳入或傳出流量上評估規則。 此參數可接受的值為：輸入和輸出。

Type:String
Accepted values:Inbound, Outbound
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

指定網路安全性規則組態的名稱。

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-NetworkSecurityGroup

指定 NetworkSecurityGroup 物件。 此 Cmdlet 會將網路安全性規則組態新增至此參數所指定的物件。

Type:PSNetworkSecurityGroup
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Priority

指定規則組態的優先順序。 此參數可接受的值為：介於 100 到 4096 之間的整數。 集合中每個規則的優先順序號碼必須是唯一的。 優先順序數位越低，規則的優先順序就越高。

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Protocol

指定規則組態套用的網路通訊協定。 此參數可接受的值為：

  • Tcp
  • Udp
  • Icmp
  • Esp
  • 啊
  • 通配符 \ 以符合所有
Type:String
Accepted values:Tcp, Udp, Icmp, Esp, Ah, *
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SourceAddressPrefix

指定來源位址前置詞。 此參數可接受的值為：

  • A CIDR
  • 來源IP範圍
  • 通配符 \ 以符合任何IP位址。 您也可以使用 VirtualNetwork、AzureLoadBalancer 和因特網等標籤。
Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SourceApplicationSecurityGroup

應用程式安全組會設定為規則的來源。 它不能與 『SourceAddressPrefix』 參數搭配使用。

Type:PSApplicationSecurityGroup[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SourceApplicationSecurityGroupId

應用程式安全組會設定為規則的來源。 它不能與 『SourceAddressPrefix』 參數搭配使用。

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SourcePortRange

指定來源埠或範圍。 這個值會以整數表示，以介於 0 到 65535 之間的範圍，或以通配符 \ 表示，以符合任何來源埠。

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

輸入

PSNetworkSecurityGroup

輸出

PSNetworkSecurityGroup