Set-AzureRmApplicationGatewayFrontendIPConfig

Modul:

AzureRM.Network

Ändert eine Front-End-IP-Adresskonfiguration.

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

Set-AzureRmApplicationGatewayFrontendIPConfig
   -ApplicationGateway <PSApplicationGateway>
   -Name <String>
   [-PrivateIPAddress <String>]
   [-SubnetId <String>]
   [-PublicIPAddressId <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Set-AzureRmApplicationGatewayFrontendIPConfig
   -ApplicationGateway <PSApplicationGateway>
   -Name <String>
   [-PrivateIPAddress <String>]
   [-Subnet <PSSubnet>]
   [-PublicIPAddress <PSPublicIpAddress>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Beschreibung

Das Cmdlet Set-AzureRmApplicationGatewayFrontendIPConfig 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

PS C:\>$PublicIp = New-AzureRmPublicIpAddress -ResourceGroupName "ResourceGroup01" -Name "PublicIp01" -location "West US" -AllocationMethod Dynamic
PS C:\> $AppGw = Get-AzureRmApplicationGateway -Name "ApplicationGateway01" -ResourceGroupName "ResourceGroup01"
PS C:\> $AppGw = Set-AzureRmApplicationGatewayFrontendIPConfig -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

PS C:\>$VNet = Get-AzureRmvirtualNetwork -Name "VNet01" -ResourceGroupName "ResourceGroup01"
PS C:\> $Subnet = Get-AzureRmVirtualNetworkSubnetConfig -Name "Subnet01" -VirtualNetwork $VNet
PS C:\> $AppGw = Get-AzureRmApplicationGateway -Name "ApplicationGateway01" -ResourceGroupName "ResourceGroup01"
PS C:\> $AppGw = Set-AzureRmApplicationGatewayFrontendIPConfig -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

PS C:\>$VNet = Get-AzureRmvirtualNetwork -Name "VNet01" -ResourceGroupName "ResourceGroup01"
PS C:\> $Subnet = Get-AzureRmVirtualNetworkSubnetConfig -Name "Subnet01" -VirtualNetwork $VNet
PS C:\> $AppGw = Get-AzureRmApplicationGateway -Name "ApplicationGateway01" -ResourceGroupName "ResourceGroup01"
PS C:\> $AppGw = Set-AzureRmApplicationGatewayFrontendIPConfig -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.

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

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

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

-PrivateIPAddress

Gibt die private IP-Adresse an. Wenn angegeben, wird diese IP statisch aus dem Subnetz zugeordnet.

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

-PublicIPAddress

Gibt die öffentliche IP-Adresse an.

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

-PublicIPAddressId

Gibt die ID der öffentlichen IP-Adresse an.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	PSSubnet
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

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

Eingaben

PSApplicationGateway

Parameter: ApplicationGateway (ByValue)

Ausgaben

PSApplicationGateway

Ähnliche Themen

• Add-AzureRmApplicationGatewayFrontendIPConfig
• Add-AzureRmApplicationGatewayFrontendIPConfig
• Get-AzureRmApplicationGatewayFrontendIPConfig
• New-AzureRmApplicationGatewayFrontendIPConfig
• Remove-AzureRmApplicationGatewayFrontendIPConfig