Add-AzApplicationGatewayFrontendIPConfig

  • Referenz
Modul:
Az.Network

Fügt einem Anwendungsgateway eine Front-End-IP-Konfiguration hinzu.

Syntax

Add-AzApplicationGatewayFrontendIPConfig
   -ApplicationGateway <PSApplicationGateway>
   -Name <String>
   [-PrivateIPAddress <String>]
   [-SubnetId <String>]
   [-PublicIPAddressId <String>]
   [-PrivateLinkConfigurationId <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Add-AzApplicationGatewayFrontendIPConfig
   -ApplicationGateway <PSApplicationGateway>
   -Name <String>
   [-PrivateIPAddress <String>]
   [-Subnet <PSSubnet>]
   [-PublicIPAddress <PSPublicIpAddress>]
   [-PrivateLinkConfiguration <PSApplicationGatewayPrivateLinkConfiguration>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Beschreibung

Das Add-AzApplicationGatewayFrontendIPConfig-Cmdlet fügt einem Anwendungsgateway eine Front-End-IP-Konfiguration hinzu. Ein Anwendungsgateway unterstützt zwei Arten von Front-End-IP-Konfigurationen:

  • Öffentliche IP-Adressen
  • Private IP-Adressen mit internem Lastenausgleich (ILB) Ein Anwendungsgateway kann höchstens eine öffentliche IP und eine private IP aufweisen. Fügen Sie die öffentliche IP-Adresse und die private IP-Adresse als separate Front-End-IPs hinzu.

Beispiele

Beispiel 1: Hinzufügen einer öffentlichen IP als Front-End-IP-Adresse

$PublicIp = New-AzPublicIpAddress -ResourceGroupName "ResourceGroup01" -Name "PublicIp01" -location "West US" -AllocationMethod Dynamic
$AppGw = Get-AzApplicationGateway -Name "ApplicationGateway01" -ResourceGroupName "ResourceGroup01"
$AppGw = Add-AzApplicationGatewayFrontendIPConfig -ApplicationGateway $AppGw -Name "FrontEndIp01" -PublicIPAddress $PublicIp

Der erste Befehl erstellt ein öffentliches IP-Adressobjekt und speichert es in der $PublicIp Variablen. Der zweite Befehl ruft das Anwendungsgateway01 ab, das zur Ressourcengruppe "ResourceGroup01" gehört, und speichert es in der $AppGw Variablen. Der dritte Befehl fügt die Front-End-IP-Konfiguration "FrontEndIp01" für das Gateway in $AppGw mithilfe der in $PublicIp gespeicherten Adresse hinzu.

Beispiel 2: Hinzufügen einer statischen privaten IP als Front-End-IP-Adresse

$VNet = Get-AzVirtualNetwork -Name "VNet01" -ResourceGroupName "ResourceGroup01"
$Subnet = Get-AzVirtualNetworkSubnetConfig -Name "Subnet01" -VirtualNetwork $VNet
$AppGw = Get-AzApplicationGateway -Name "ApplicationGateway01" -ResourceGroupName "ResourceGroup01"
$AppGw = Add-AzApplicationGatewayFrontendIPConfig -ApplicationGateway $AppGw -Name "FrontendIP02" -Subnet $Subnet -PrivateIPAddress 10.0.1.1

Der erste Befehl ruft ein virtuelles Netzwerk namens VNet01 ab, das zur Ressourcengruppe "ResourceGroup01" gehört, und speichert es in der $VNet Variablen. Der zweite Befehl ruft eine Subnetzkonfiguration namens Subnetz01 mithilfe von $VNet aus dem ersten Befehl ab und speichert sie in der variablen $Subnet. Der dritte Befehl ruft das Anwendungsgateway01 ab, das zur Ressourcengruppe "ResourceGroup01" gehört, und speichert es in der variablen $AppGw. Der vierte Befehl fügt eine Front-End-IP-Konfiguration namens FrontendIP02 mithilfe von $Subnet aus dem zweiten Befehl und der privaten IP-Adresse 10.0.1.1 hinzu.

Beispiel 3: Hinzufügen einer dynamischen privaten IP als Front-End-IP-Adresse

$VNet = Get-AzVirtualNetwork -Name "VNet01" -ResourceGroupName "ResourceGroup01"
$Subnet = Get-AzVirtualNetworkSubnetConfig -Name "Subnet01" -VirtualNetwork $VNet
$AppGw = Get-AzApplicationGateway -Name "ApplicationGateway01" -ResourceGroupName "ResourceGroup01"
$AppGw = Add-AzApplicationGatewayFrontendIPConfig -ApplicationGateway $AppGw -Name "FrontendIP02" -Subnet $Subnet

Der erste Befehl ruft ein virtuelles Netzwerk namens VNet01 ab, das zur Ressourcengruppe "ResourceGroup01" gehört, und speichert es in der $VNet Variablen. Der zweite Befehl ruft eine Subnetzkonfiguration namens Subnetz01 mithilfe von $VNet aus dem ersten Befehl ab und speichert sie in der variablen $Subnet. Der dritte Befehl ruft das Anwendungsgateway01 ab, das zur Ressourcengruppe "ResourceGroup01" gehört, und speichert es in der variablen $AppGw. Der vierte Befehl fügt eine Front-End-IP-Konfiguration namens FrontendIP02 mithilfe von $Subnet aus dem zweiten Befehl hinzu.

Parameter

-ApplicationGateway

Gibt das Anwendungsgateway an, dem dieses Cmdlet eine Front-End-IP-Konfiguration hinzufügt.

Typ:PSApplicationGateway
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-DefaultProfile

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

Typ:IAzureContextContainer
Aliase:AzContext, AzureRmContext, AzureCredential
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Name

Gibt den Namen der hinzuzufügenden Front-End-IP-Konfiguration an.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-PrivateIPAddress

Gibt die private IP-Adresse an, die als Front-End-IP für das Anwendungsgateway hinzugefügt werden soll. Wenn angegeben, wird diese IP statisch aus dem Subnetz zugeordnet.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-PrivateLinkConfiguration

PrivateLinkConfiguration

Typ:PSApplicationGatewayPrivateLinkConfiguration
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-PrivateLinkConfigurationId

PrivateLinkConfigurationId

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-PublicIPAddress

Gibt die öffentliche IP-Adresse an, die dieses Cmdlet als Front-End-IP-Adresse für das Anwendungsgateway hinzufügt.

Typ:PSPublicIpAddress
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-PublicIPAddressId

Gibt die ID der öffentlichen IP-Adresse an, die dieses Cmdlet als Front-End-IP-Adresse für das Anwendungsgateway hinzufügt.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Subnet

Gibt das Subnetz an, das dieses Cmdlet als Front-End-IP-Konfiguration hinzufügt. Wenn Sie diesen Parameter angeben, bedeutet dies, dass das Anwendungsgateway eine private IP-basierte Konfiguration unterstützt. Wenn der Parameter "PrivateIPAddress " angegeben ist, sollte er zu diesem Subnetz gehören. Wenn PrivateIPAddress nicht angegeben ist, wird eine der IP-Adressen aus diesem Subnetz dynamisch als Front-End-IP-Adresse des Anwendungsgateways aufgenommen.

Typ:PSSubnet
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-SubnetId

Gibt die Subnetz-ID an, die dieses Cmdlet als Front-End-IP-Konfiguration hinzufügt. Das Übergeben von Subnetz impliziert private IP. Wenn der Parameter "PrivateIPAddress " angegeben ist, sollte er zu diesem Subnetz gehören. Andernfalls wird eine der IP-Adressen dieses Subnetzes dynamisch als Front-End-IP des Anwendungsgateways aufgenommen.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

PSApplicationGateway

Ausgaben

PSApplicationGateway