Get-AzureRmFirewall

Referenz

Modul:: AzureRM.Network

Ruft eine Azure-Firewall ab.

Warnung

Das AzureRM PowerShell-Modul ist seit dem 29. Februar 2024 offiziell veraltet. Benutzern wird empfohlen, von AzureRM zum Az PowerShell-Modul zu migrieren, um weiterhin Support und Updates zu erhalten.

Obwohl das AzureRM-Modul weiterhin funktioniert, wird es nicht mehr Standard tained oder unterstützt, wobei eine fortgesetzte Verwendung nach Ermessen und Risiko des Benutzers erfolgt. Weitere Informationen zum Übergang zum Az-Modul finden Sie in unseren Migrationsressourcen.

Syntax

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

Beschreibung

Das Cmdlet "Get-AzureRmFirewall " ruft eine oder mehrere Firewalls in einer Ressourcengruppe ab.

Beispiele

1: Abrufen aller Firewalls in einer Ressourcengruppe

Get-AzureRmFirewall -ResourceGroupName rgName

In diesem Beispiel werden alle Firewalls in der Ressourcengruppe "rgName" abgerufen.

2: Abrufen einer Firewall anhand des Namens

Get-AzureRmFirewall -ResourceGroupName rgName -Name azFw

In diesem Beispiel wird die Firewall mit dem Namen "azFw" in der Ressourcengruppe "rgName" abgerufen.

3: Abrufen einer Firewall und anschließendes Hinzufügen einer Anwendungsregelsammlung zur Firewall

$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)

In diesem Beispiel wird eine Firewall abgerufen. Anschließend wird der Firewall eine Anwendungsregelauflistung durch Aufrufen der Methode "AddApplicationRuleCollection" hinzugefügt.

4: Abrufen einer Firewall und anschließendes Hinzufügen einer Netzwerkregelsammlung zur Firewall

$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)

In diesem Beispiel wird eine Firewall abgerufen. Anschließend wird der Firewall eine Netzwerkregelauflistung durch Aufrufen der Methode "AddNetworkRuleCollection" hinzugefügt.

5: Abrufen einer Firewall und anschließendes Abrufen einer Anwendungsregelsammlung anhand des Namens aus der Firewall

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

In diesem Beispiel wird eine Firewall abgerufen und anschließend eine Regelauflistung anhand des Namens abgerufen, wobei die Methode GetApplicationRuleCollectionByName für das Firewallobjekt aufgerufen wird. Der Name der Regelauflistung für die Methode "GetApplicationRuleCollectionByName" wird zwischen Groß- und Kleinschreibung unterschieden.

6: Abrufen einer Firewall und anschließendes Abrufen einer Netzwerkregelsammlung anhand des Namens aus der Firewall

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

In diesem Beispiel wird eine Firewall abgerufen und anschließend eine Regelauflistung anhand des Namens abgerufen, wobei die Methode GetNetworkRuleCollectionByName für das Firewallobjekt aufgerufen wird. Der Name der Regelauflistung für die Methode "GetNetworkRuleCollectionByName" wird zwischen Groß- und Kleinschreibung unterschieden.

7: Abrufen einer Firewall und Entfernen einer Anwendungsregelsammlung anhand des Namens aus der Firewall

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

In diesem Beispiel wird eine Firewall abgerufen und anschließend eine Regelauflistung anhand des Namens entfernt, wobei die Methode RemoveApplicationRuleCollectionByName für das Firewallobjekt aufgerufen wird. Der Name der Regelauflistung für die Methode RemoveApplicationRuleCollectionByName wird zwischen Groß- und Kleinschreibung unterschieden.

8: Abrufen einer Firewall und Entfernen einer Netzwerkregelsammlung anhand des Namens aus der Firewall

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

In diesem Beispiel wird eine Firewall abgerufen und anschließend eine Regelauflistung anhand des Namens entfernt, wobei die Methode RemoveNetworkRuleCollectionByName für das Firewallobjekt aufgerufen wird. Der Name der Regelauflistung für die Methode RemoveNetworkRuleCollectionByName wird zwischen Groß- und Kleinschreibung unterschieden.

9: Abrufen einer Firewall und Zuordnen der Firewall

$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)

In diesem Beispiel wird eine Firewall abgerufen und aufruft "Zuweisen" für die Firewall, um den Firewalldienst mithilfe der Konfiguration (Anwendungs- und Netzwerkregelsammlungen) zu starten, die der Firewall zugeordnet sind.

Parameter

-DefaultProfile

Die Anmeldeinformationen, Konten, Mandanten und Abonnements, die für die Kommunikation mit Azure verwendet werden.

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

-Name

Gibt den Namen der Firewall an, die dieses Cmdlet abruft.

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

-ResourceGroupName

Gibt den Namen der Ressourcengruppe an, zu der die Firewall gehört.

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

Eingaben

None

Dieses Cmdlet nimmt keine Eingabe an.

Ausgaben

PSAzureFirewall