Partager via


Get-AzureRmFirewall

Obtient une Pare-feu Azure.

Avertissement

Le module AzureRM PowerShell a été officiellement déprécié le 29 février 2024. Les utilisateurs sont invités à migrer d’AzureRM vers le module Az PowerShell afin de s’assurer d’une prise en charge et des mises à jour continues.

Il est possible que le module AzureRM fonctionne encore, mais il ne fait plus l’objet de maintenance ni de support. L’utilisateur peut continuer à s’en servir s’il le souhaite, à ses propres risques. Consultez nos ressources sur la migration pour obtenir des conseils sur la transition vers le module Az.

Syntaxe

Get-AzureRmFirewall
   [-Name <String>]
   [-ResourceGroupName <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Description

L’applet de commande Get-AzureRmFirewall obtient un ou plusieurs pare-feu dans un groupe de ressources.

Exemples

1 : Récupérer tous les pare-feu dans un groupe de ressources

Get-AzureRmFirewall -ResourceGroupName rgName

Cet exemple récupère tous les pare-feu dans le groupe de ressources « rgName ».

2 : Récupérer un pare-feu par nom

Get-AzureRmFirewall -ResourceGroupName rgName -Name azFw

Cet exemple récupère le pare-feu nommé « azFw » dans le groupe de ressources « rgName ».

3 : Récupérer un pare-feu, puis ajouter une collection de règles d’application au pare-feu

$azFw=Get-AzureRmFirewall -Name "azFw" -ResourceGroupName "rgName"
$appRule = New-AzureRmFirewallApplicationRule -Name R1 -Protocol "http:80","https:443" -TargetFqdn "*google.com", "*microsoft.com" -SourceAddress "10.0.0.0"
$appRuleCollection = New-AzureRmFirewallApplicationRuleCollection -Name "MyAppRuleCollection" -Priority 100 -Rule $appRule -ActionType "Allow"
$azFw.AddApplicationRuleCollection($appRuleCollection)

Cet exemple récupère un pare-feu, puis ajoute une collection de règles d’application au pare-feu en appelant la méthode AddApplicationRuleCollection.

4 : Récupérer un pare-feu, puis ajouter une collection de règles réseau au pare-feu

$azFw=Get-AzureRmFirewall -Name "azFw" -ResourceGroupName "rgName"
$netRule = New-AzureRmFirewallNetworkRule -Name "all-udp-traffic" -Description "Rule for all UDP traffic" -Protocol "Udp" -SourceAddress "*" -DestinationAddress "*" -DestinationPort "*"
$netRuleCollection = New-AzureRmFirewallNetworkRuleCollection -Name "MyNetworkRuleCollection" -Priority 100 -Rule $netRule -ActionType "Allow"
$azFw.AddNetworkRuleCollection($netRuleCollection)

Cet exemple récupère un pare-feu, puis ajoute une collection de règles réseau au pare-feu en appelant la méthode AddNetworkRuleCollection.

5 : Récupérer un pare-feu, puis récupérer une collection de règles d’application par nom à partir du pare-feu

$azFw=Get-AzureRmFirewall -Name "azFw" -ResourceGroupName "rgName"
$getAppRc=$azFw.GetApplicationRuleCollectionByName("MyAppRuleCollection")

Cet exemple récupère un pare-feu, puis obtient une collection de règles par nom, en appelant la méthode GetApplicationRuleCollectionByName sur l’objet de pare-feu. Le nom de la collection de règles pour la méthode GetApplicationRuleCollectionByName ne respecte pas la casse.

6 : Récupérer un pare-feu, puis récupérer une collection de règles réseau par nom à partir du pare-feu

$azFw=Get-AzureRmFirewall -Name "azFw" -ResourceGroupName "rgName"
$getNetRc=$azFw.GetNetworkRuleCollectionByName("MyNetworkRuleCollection")

Cet exemple récupère un pare-feu, puis obtient une collection de règles par nom, en appelant la méthode GetNetworkRuleCollectionByName sur l’objet de pare-feu. Le nom de la collection de règles pour la méthode GetNetworkRuleCollectionByName ne respecte pas la casse.

7 : Récupérer un pare-feu, puis supprimer une collection de règles d’application par nom du pare-feu

$azFw=Get-AzureRmFirewall -Name "azFw" -ResourceGroupName "rgName"
$azFw.RemoveApplicationRuleCollectionByName("MyAppRuleCollection")

Cet exemple récupère un pare-feu, puis supprime une collection de règles par nom, en appelant la méthode RemoveApplicationRuleCollectionByName sur l’objet de pare-feu. Le nom de la collection de règles pour la méthode RemoveApplicationRuleCollectionByName ne respecte pas la casse.

8 : Récupérer un pare-feu, puis supprimer une collection de règles réseau par nom du pare-feu

$azFw=Get-AzureRmFirewall -Name "azFw" -ResourceGroupName "rgName"
$azFw.RemoveNetworkRuleCollectionByName("MyNetworkRuleCollection")

Cet exemple récupère un pare-feu, puis supprime une collection de règles par nom, en appelant la méthode RemoveNetworkRuleCollectionByName sur l’objet de pare-feu. Le nom de la collection de règles pour la méthode RemoveNetworkRuleCollectionByName ne respecte pas la casse.

9 : Récupérer un pare-feu, puis allouer le pare-feu

$vnet=Get-AzureRmVirtualNetwork -Name "vnet" -ResourceGroupName "rgName"
$publicIp=Get-AzureRmPublicIpAddress -Name "firewallpip" -ResourceGroupName "rgName"
$azFw=Get-AzureRmFirewall -Name "azFw" -ResourceGroupName "rgName"
$azFw.Allocate($vnet, $publicIp)

Cet exemple récupère un pare-feu et appelle Allocate sur le pare-feu pour démarrer le service de pare-feu à l’aide de la configuration (collections d’applications et de règles réseau) associée au pare-feu.

Paramètres

-DefaultProfile

Informations d’identification, compte, locataire et abonnement utilisés pour la communication avec Azure.

Type:IAzureContextContainer
Alias:AzureRmContext, AzureCredential
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Name

Spécifie le nom du pare-feu que cette applet de commande obtient.

Type:String
Alias:ResourceName
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-ResourceGroupName

Spécifie le nom du groupe de ressources auquel appartient le pare-feu.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

Entrées

None

Cette applet de commande n’accepte aucune entrée.

Sorties

PSAzureFirewall