Set-AzApplicationGatewayFrontendIPConfig

  • Referenz
Modul:
Az.Network

Ändert eine Front-End-IP-Adresskonfiguration.

Syntax

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

Beschreibung

Das Cmdlet Set-AzApplicationGatewayFrontendIPConfig aktualisiert eine Front-End-IP-Konfiguration. Ein Anwendungsgateway unterstützt zwei Arten von Front-End-IP-Adressen:

  • Öffentliche IP-Adressen
  • Private IP-Adressen, für die die Konfiguration den internen Lastenausgleich (Internal Load Balancing, ILB) verwendet. Ein Anwendungsgateway kann höchstens eine öffentliche IP-Adresse und eine private IP-Adresse aufweisen. Eine öffentliche IP-Adresse und eine private IP-Adresse sollten separat als Front-End-IP-Adressen hinzugefügt werden.

Beispiele

Beispiel 1: Festlegen einer öffentlichen IP als Front-End-IP eines Anwendungsgateways

$PublicIp = New-AzPublicIpAddress -ResourceGroupName "ResourceGroup01" -Name "PublicIp01" -location "West US" -AllocationMethod Dynamic
$AppGw = Get-AzApplicationGateway -Name "ApplicationGateway01" -ResourceGroupName "ResourceGroup01"
$AppGw = Set-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 aktualisiert die Front-End-IP-Konfiguration mit dem Namen FrontEndIp01 für das Gateway in $AppGw unter Verwendung der in $PublicIp gespeicherten Adresse.

Beispiel 2: Festlegen einer statischen privaten IP als Front-End-IP eines Anwendungsgateways

$VNet = Get-AzVirtualNetwork -Name "VNet01" -ResourceGroupName "ResourceGroup01"
$Subnet = Get-AzVirtualNetworkSubnetConfig -Name "Subnet01" -VirtualNetwork $VNet
$AppGw = Get-AzApplicationGateway -Name "ApplicationGateway01" -ResourceGroupName "ResourceGroup01"
$AppGw = Set-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: Festlegen einer dynamischen privaten IP als Front-End-IP eines Anwendungsgateways

$VNet = Get-AzVirtualNetwork -Name "VNet01" -ResourceGroupName "ResourceGroup01"
$Subnet = Get-AzVirtualNetworkSubnetConfig -Name "Subnet01" -VirtualNetwork $VNet
$AppGw = Get-AzApplicationGateway -Name "ApplicationGateway01" -ResourceGroupName "ResourceGroup01"
$AppGw = Set-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 ein Anwendungsgatewayobjekt an, in dem die Front-End-IP-Konfiguration geändert werden soll.

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 Front-End-IP-Konfiguration an, die dieses Cmdlet ändert.

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

-PrivateIPAddress

Gibt die private IP-Adresse an. 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.

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

-PublicIPAddressId

Gibt die ID der öffentlichen IP-Adresse an.

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

-Subnet

Gibt das Subnetz an, das vom Anwendungsgateway verwendet wird. Geben Sie diesen Parameter an, wenn das Gateway eine private IP-Adresse verwendet. Wenn die PrivateIPAddress-Adresse angegeben ist, sollte sie 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. Geben Sie diesen Parameter an, wenn das Gateway eine private IP-Adresse verwendet. 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:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

PSApplicationGateway

Ausgaben

PSApplicationGateway