New-AzFirewallPolicy

參考

模組:: Az.Network

建立新的 Azure 防火牆原則

語法

New-AzFirewallPolicy
   -Name <String>
   -ResourceGroupName <String>
   -Location <String>
   [-ThreatIntelMode <String>]
   [-ThreatIntelWhitelist <PSAzureFirewallPolicyThreatIntelWhitelist>]
   [-BasePolicy <String>]
   [-DnsSetting <PSAzureFirewallPolicyDnsSettings>]
   [-SqlSetting <PSAzureFirewallPolicySqlSetting>]
   [-Tag <Hashtable>]
   [-Force]
   [-AsJob]
   [-IntrusionDetection <PSAzureFirewallPolicyIntrusionDetection>]
   [-TransportSecurityName <String>]
   [-TransportSecurityKeyVaultSecretId <String>]
   [-SkuTier <String>]
   [-UserAssignedIdentityId <String>]
   [-Identity <PSManagedServiceIdentity>]
   [-PrivateRange <String[]>]
   [-ExplicitProxy <PSAzureFirewallPolicyExplicitProxy>]
   [-Snat <PSAzureFirewallPolicySNAT>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

New-AzFirewallPolicy Cmdlet 會建立 Azure 防火牆原則。

範例

範例 1：建立空白原則

New-AzFirewallPolicy -Name fp1 -ResourceGroupName TestRg

此範例會建立 Azure 防火牆原則

範例 2：使用 ThreatIntel 模式建立空白原則

New-AzFirewallPolicy -Name fp1 -ResourceGroupName TestRg -ThreatIntelMode "Deny"

此範例會建立具有威脅 Intel 模式的 Azure 防火牆原則

範例 3：使用 ThreatIntelWhitelist 建立空白原則

$threatIntelWhitelist = New-AzFirewallPolicyThreatIntelWhitelist -IpAddress 23.46.72.91,192.79.236.79 -FQDN microsoft.com
New-AzFirewallPolicy -Name fp1 -ResourceGroupName TestRg -ThreatIntelWhitelist $threatIntelWhitelist

此範例會建立具有威脅 Intel allowlist 的 Azure 防火牆原則

範例 4：建立具有入侵檢測、身分識別和傳輸安全性的原則

$bypass = New-AzFirewallPolicyIntrusionDetectionBypassTraffic -Name "bypass-setting" -Protocol "TCP" -DestinationPort "80" -SourceAddress "10.0.0.0" -DestinationAddress "*"
$signatureOverride = New-AzFirewallPolicyIntrusionDetectionSignatureOverride -Id "123456798" -Mode "Deny"
$intrusionDetection = New-AzFirewallPolicyIntrusionDetection -Mode "Alert" -SignatureOverride $signatureOverride -BypassTraffic $bypass
$userAssignedIdentity = '/subscriptions/9e223dbe-3399-4e19-88eb-0975f02ac87f/resourcegroups/TestRg/providers/Microsoft.ManagedIdentity/userAssignedIdentities/user-assign-identity'
New-AzFirewallPolicy -Name fp1 -Location "westus2" -ResourceGroupName TestRg -SkuTier "Premium" -IntrusionDetection $intrusionDetection -TransportSecurityName tsName -TransportSecurityKeyVaultSecretId "https://<keyvaultname>.vault.azure.net/secrets/cacert"  -UserAssignedIdentityId $userAssignedIdentity

此範例會在模式警示、使用者指派的身分識別和傳輸安全性中建立具有入侵偵測的 Azure 防火牆原則

範例 5：建立具有自定義私人範圍設定的空白防火牆原則

New-AzFirewallPolicy -Name fp1 -ResourceGroupName TestRg -PrivateRange @("99.99.99.0/24", "66.66.0.0/16")

此範例會建立防火牆，將 “99.99.99.0/24” 和 “66.66.0.0.0/16” 視為私人 IP 範圍，且不會為這些位址的流量產生自然流量

範例 6：使用明確 Proxy 設定建立空白防火牆原則

$exProxy = New-AzFirewallPolicyExplicitProxy -EnableExplicitProxy  -HttpPort 100 -HttpsPort 101 -EnablePacFile  -PacFilePort 130 -PacFile "sampleurlfortesting.blob.core.windowsnet/nothing"
New-AzFirewallPolicy -Name fp1 -ResourceGroupName TestRg -ExplicitProxy $exProxy

BasePolicy	                : null	
		DnsSettings  	            : null	
		Etag	                    : null	
		ExplicitProxy	
			EnableExplicitProxy	    : true	
			EnablePacFile	        : true	
			HttpPort	            : 100	
			HttpsPort	            : 101	
			PacFile                 : "sampleurlfortesting.blob.core.windowsnet/nothing"
			PacFilePort	            : 130	
		Id	                        : null	
		Identity	                : null	
		IntrusionDetection	        : null	
		Location	                : "westus2"	
		Name	                    : "fp1"	
		PrivateRange	            : null
		PrivateRangeText	        : "[]"
		ProvisioningState	        : null	
		ResourceGroupName	        : "TestRg"	
		ResourceGuid	            : null	
		RuleCollectionGroups	    : null	
		Sku	
			Tier	                : "Standard"	
		Snat	
			AutoLearnPrivateRanges	: null	
			PrivateRanges	        : null	
		SqlSetting	                : null	
		Tag	                        : null	
		TagsTable	                : null	
		ThreatIntelMode	            : "Alert"	
		ThreatIntelWhitelist	    : null	
		TransportSecurity	        : null	
		Type	                    : null

此範例會建立具有明確 Proxy 設定的防火牆原則

參數

-AsJob

在背景執行 Cmdlet

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-BasePolicy

要繼承自的基底原則

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	True
接受萬用字元:	False

-Confirm

在執行 Cmdlet 之前，提示您進行確認。

類型:	SwitchParameter
別名:	cf
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-DefaultProfile

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

類型:	IAzureContextContainer
別名:	AzContext, AzureRmContext, AzureCredential
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-DnsSetting

DNS 設定

類型:	PSAzureFirewallPolicyDnsSettings
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-ExplicitProxy

明確 Proxy 設定

類型:	PSAzureFirewallPolicyExplicitProxy
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Force

如果您想要覆寫資源，請勿要求確認

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Identity

要指派給防火牆原則的防火牆原則身分識別。

類型:	PSManagedServiceIdentity
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-IntrusionDetection

入侵檢測設定

類型:	PSAzureFirewallPolicyIntrusionDetection
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Location

位置。

類型:	String
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	True
接受萬用字元:	False

-Name

資源名稱。

類型:	String
別名:	ResourceName
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	True
接受萬用字元:	False

-PrivateRange

流量不會受到 SNAT 保護的私人 IP 範圍

類型:	String[]
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-ResourceGroupName

資源組名。

類型:	String
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	True
接受萬用字元:	False

-SkuTier

防火牆原則 SKU 層

類型:	String
接受的值:	Standard, Premium, Basic
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Snat

防火牆原則中流量不會是 SNAT 的私人IP位址/IP範圍。

類型:	PSAzureFirewallPolicySNAT
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-SqlSetting

SQL 相關設定

類型:	PSAzureFirewallPolicySqlSetting
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Tag

表示資源標記的哈希表。

類型:	Hashtable
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	True
接受萬用字元:	False

-ThreatIntelMode

威脅情報的作業模式。

類型:	String
接受的值:	Alert, Deny, Off
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	True
接受萬用字元:	False

-ThreatIntelWhitelist

威脅情報的允許清單

類型:	PSAzureFirewallPolicyThreatIntelWhitelist
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-TransportSecurityKeyVaultSecretId

秘密標識碼（base-64 編碼未加密的 pfx） 'Secret' 或 'Certificate' 物件儲存在 KeyVault 中

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-TransportSecurityName

傳輸安全性名稱

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-UserAssignedIdentityId

要指派給防火牆原則之使用者指派身分識別的 ResourceId。

類型:	String
別名:	UserAssignedIdentity
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-WhatIf

顯示 Cmdlet 執行時會發生什麼事。 Cmdlet 未執行。

類型:	SwitchParameter
別名:	wi
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

輸入

String

Hashtable

輸出

PSAzureFirewall

共用方式為

New-AzFirewallPolicy

語法

Description

範例

範例 1：建立空白原則

範例 2：使用 ThreatIntel 模式建立空白原則

範例 3：使用 ThreatIntelWhitelist 建立空白原則

範例 4：建立具有入侵檢測、身分識別和傳輸安全性的原則

範例 5：建立具有自定義私人範圍設定的空白防火牆原則

範例 6：使用明確 Proxy 設定建立空白防火牆原則

參數

-AsJob

-BasePolicy

-Confirm

-DefaultProfile

-DnsSetting

-ExplicitProxy

-Force

-Identity

-IntrusionDetection

-Location

-Name

-PrivateRange

-ResourceGroupName

-SkuTier

-Snat

-SqlSetting

-Tag

-ThreatIntelMode

-ThreatIntelWhitelist

-TransportSecurityKeyVaultSecretId

-TransportSecurityName

-UserAssignedIdentityId

-WhatIf

輸入

輸出

其他資源

共用方式為

New-AzFirewallPolicy

語法

Description

範例

範例 1：建立空白原則

範例 2：使用 ThreatIntel 模式建立空白原則

範例 3：使用 ThreatIntelWhitelist 建立空白原則

範例 4：建立具有入侵檢測、身分識別和傳輸安全性的原則

範例 5：建立具有自定義私人範圍設定的空白防火牆原則

範例 6：使用明確 Proxy 設定建立空白防火牆原則

參數

-AsJob

-BasePolicy

-Confirm

-DefaultProfile

-DnsSetting

-ExplicitProxy

-Force

-Identity

-IntrusionDetection

-Location

-Name

-PrivateRange

-ResourceGroupName

-SkuTier

-Snat

-SqlSetting

-Tag

-ThreatIntelMode

-ThreatIntelWhitelist

-TransportSecurityKeyVaultSecretId

-TransportSecurityName

-UserAssignedIdentityId

-WhatIf

輸入

輸出

相關連結

其他資源