New-AzFirewallPolicy

Referencia

Módulo:: Az.Network

Crea una nueva directiva de Azure Firewall

Sintaxis

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

El cmdlet New-AzFirewallPolicy crea una directiva de Azure Firewall.

Ejemplos

Ejemplo 1: Creación de una directiva vacía

New-AzFirewallPolicy -Name fp1 -ResourceGroupName TestRg

En este ejemplo se crea una directiva de Azure Firewall.

Ejemplo 2: Creación de una directiva vacía con el modo ThreatIntel

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

En este ejemplo se crea una directiva de Azure Firewall con un modo intel de amenazas.

Ejemplo 3: Crear una directiva vacía con ThreatIntelWhitelist

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

En este ejemplo se crea una directiva de Azure Firewall con una lista de permitidos de Intel de amenazas.

Ejemplo 4: Creación de una directiva con detección de intrusiones, identidad y seguridad de transporte

$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

En este ejemplo se crea una directiva de Azure Firewall con una alerta de detección de intrusiones en modo, la identidad asignada por el usuario y la seguridad de transporte.

Ejemplo 5: Creación de una directiva de firewall vacía con la configuración personalizada del intervalo privado

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

En este ejemplo se crea un firewall que trata "99.99.99.0/24" y "66.66.0.0/16" como intervalos IP privados y no se quita el tráfico a esas direcciones.

Ejemplo 6: Crear una directiva de firewall vacía con configuración de proxy explícita

$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

En este ejemplo se crea una directiva de firewall con la configuración de proxy explícita.

Parámetros

-AsJob

Ejecución del cmdlet en segundo plano

Tipo:	SwitchParameter
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-BasePolicy

Directiva base de la que se va a heredar

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-Confirm

Le solicita su confirmación antes de ejecutar el cmdlet.

Tipo:	SwitchParameter
Alias:	cf
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-DefaultProfile

Credenciales, cuenta, inquilino y suscripción usados para la comunicación con Azure.

Tipo:	IAzureContextContainer
Alias:	AzContext, AzureRmContext, AzureCredential
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-DnsSetting

Configuración de DNS

Tipo:	PSAzureFirewallPolicyDnsSettings
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-ExplicitProxy

Configuración explícita del proxy

Tipo:	PSAzureFirewallPolicyExplicitProxy
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Force

No solicite confirmación si desea sobrescribir un recurso

Tipo:	SwitchParameter
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Identity

Identidad de directiva de firewall que se va a asignar a la directiva de firewall.

Tipo:	PSManagedServiceIdentity
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-IntrusionDetection

Configuración de detección de intrusiones

Tipo:	PSAzureFirewallPolicyIntrusionDetection
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Location

ubicación.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-Name

Nombre del recurso.

Tipo:	String
Alias:	ResourceName
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-PrivateRange

Intervalos IP privados a los que el tráfico no será SNAT.

Tipo:	String[]
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-ResourceGroupName

El nombre del grupo de recursos.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-SkuTier

Nivel de SKU de directiva de firewall

Tipo:	String
Valores aceptados:	Standard, Premium, Basic
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Snat

Las direcciones IP privadas o los intervalos IP a los que el tráfico no será SNAT en la directiva de firewall.

Tipo:	PSAzureFirewallPolicySNAT
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-SqlSetting

Configuración relacionada con SQL

Tipo:	PSAzureFirewallPolicySqlSetting
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Tag

Tabla hash que representa etiquetas de recursos.

Tipo:	Hashtable
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-ThreatIntelMode

Modo de operación para inteligencia sobre amenazas.

Tipo:	String
Valores aceptados:	Alert, Deny, Off
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-ThreatIntelWhitelist

Lista de permitidos de inteligencia sobre amenazas

Tipo:	PSAzureFirewallPolicyThreatIntelWhitelist
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-TransportSecurityKeyVaultSecretId

Id. de secreto del objeto 'Secret' o 'Certificate' almacenado en KeyVault (objeto pfx sin cifrar codificado en base 64) 'Secret' o 'Certificate' almacenado en KeyVault

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-TransportSecurityName

Nombre de seguridad de transporte

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-UserAssignedIdentityId

ResourceId de la identidad asignada por el usuario que se va a asignar a la directiva de firewall.

Tipo:	String
Alias:	UserAssignedIdentity
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-WhatIf

Muestra lo que sucedería si se ejecutara el cmdlet. El cmdlet no se ejecuta.

Tipo:	SwitchParameter
Alias:	wi
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

Entradas

String

Hashtable

Salidas

PSAzureFirewall

Compartir a través de

New-AzFirewallPolicy

Sintaxis

Description

Ejemplos

Ejemplo 1: Creación de una directiva vacía

Ejemplo 2: Creación de una directiva vacía con el modo ThreatIntel

Ejemplo 3: Crear una directiva vacía con ThreatIntelWhitelist

Ejemplo 4: Creación de una directiva con detección de intrusiones, identidad y seguridad de transporte

Ejemplo 5: Creación de una directiva de firewall vacía con la configuración personalizada del intervalo privado

Ejemplo 6: Crear una directiva de firewall vacía con configuración de proxy explícita

Parámetros

-AsJob

-BasePolicy

-Confirm

-DefaultProfile

-DnsSetting

-ExplicitProxy

-Force

-Identity

-IntrusionDetection

-Location

-Name

-PrivateRange

-ResourceGroupName

-SkuTier

-Snat

-SqlSetting

-Tag

-ThreatIntelMode

-ThreatIntelWhitelist

-TransportSecurityKeyVaultSecretId

-TransportSecurityName

-UserAssignedIdentityId

-WhatIf

Entradas

Salidas

Recursos adicionales

Compartir a través de

New-AzFirewallPolicy

Sintaxis

Description

Ejemplos

Ejemplo 1: Creación de una directiva vacía

Ejemplo 2: Creación de una directiva vacía con el modo ThreatIntel

Ejemplo 3: Crear una directiva vacía con ThreatIntelWhitelist

Ejemplo 4: Creación de una directiva con detección de intrusiones, identidad y seguridad de transporte

Ejemplo 5: Creación de una directiva de firewall vacía con la configuración personalizada del intervalo privado

Ejemplo 6: Crear una directiva de firewall vacía con configuración de proxy explícita

Parámetros

-AsJob

-BasePolicy

-Confirm

-DefaultProfile

-DnsSetting

-ExplicitProxy

-Force

-Identity

-IntrusionDetection

-Location

-Name

-PrivateRange

-ResourceGroupName

-SkuTier

-Snat

-SqlSetting

-Tag

-ThreatIntelMode

-ThreatIntelWhitelist

-TransportSecurityKeyVaultSecretId

-TransportSecurityName

-UserAssignedIdentityId

-WhatIf

Entradas

Salidas

Vínculos relacionados

Recursos adicionales