Share via

Set-AzureRmApplicationGatewayFrontendIPConfig

  • Reference
Modul:
AzureRM.Network

Upraví konfiguraci front-endové IP adresy.

Upozorňující

Modul AzureRM PowerShell byl od 29. února 2024 oficiálně zastaralý. Uživatelům se doporučuje migrovat z AzureRM do modulu Az PowerShell, aby se zajistila nepřetržitá podpora a aktualizace.

I když může modul AzureRM stále fungovat, už se neudržuje ani nepodporuje, přičemž jakékoli další použití se bude umisťovat podle vlastního uvážení a rizika uživatele. Pokyny k přechodu na modul Az najdete v našich zdrojích informací o migraci.

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>]

Description

Rutina Set-AzureRmApplicationGatewayFrontendIPConfig aktualizuje konfiguraci front-endOVÉ IP adresy. Aplikační brána podporuje dva typy front-endových IP adres:

  • veřejné IP adresy,
  • Privátní IP adresy, pro které konfigurace používá interní vyrovnávání zatížení (ILB), může mít aplikační brána maximálně jednu veřejnou IP adresu a jednu privátní IP adresu. Veřejná IP adresa a privátní IP adresa by se měly přidat samostatně jako front-endové IP adresy.

Příklady

Příklad 1: Nastavení veřejné IP adresy jako front-endové IP adresy aplikační brány

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

První příkaz vytvoří objekt veřejné IP adresy a uloží ho do proměnné $PublicIp. Druhý příkaz získá aplikační bránu s názvem ApplicationGateway01, která patří do skupiny prostředků s názvem ResourceGroup01, a uloží ji do proměnné $AppGw. Třetí příkaz aktualizuje konfiguraci front-endOVÉ IP adresy s názvem FrontEndIp01 pro bránu v $AppGw pomocí adresy uložené v $PublicIp.

Příklad 2: Nastavení statické privátní IP adresy jako front-endové IP adresy aplikační brány

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

První příkaz získá virtuální síť s názvem VNet01, která patří do skupiny prostředků s názvem ResourceGroup01, a uloží ji do proměnné $VNet. Druhý příkaz získá konfiguraci podsítě s názvem Subnet01 pomocí $VNet z prvního příkazu a uloží ji do proměnné $Subnet. Třetí příkaz získá aplikační bránu s názvem ApplicationGateway01, která patří do skupiny prostředků s názvem ResourceGroup01, a uloží ji do proměnné $AppGw. Čtvrtý příkaz přidá konfiguraci front-end IP adresy s názvem FrontendIP02 pomocí $Subnet z druhého příkazu a privátní IP adresy 10.0.1.1.

Příklad 3: Nastavení dynamické privátní IP adresy jako front-endové IP adresy aplikační brány

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

První příkaz získá virtuální síť s názvem VNet01, která patří do skupiny prostředků s názvem ResourceGroup01, a uloží ji do proměnné $VNet. Druhý příkaz získá konfiguraci podsítě s názvem Subnet01 pomocí $VNet z prvního příkazu a uloží ji do proměnné $Subnet. Třetí příkaz získá aplikační bránu s názvem ApplicationGateway01, která patří do skupiny prostředků s názvem ResourceGroup01, a uloží ji do proměnné $AppGw. Čtvrtý příkaz přidá konfiguraci front-endOVÉ IP adresy s názvem FrontendIP02 pomocí $Subnet z druhého příkazu.

Parametry

-ApplicationGateway

Určuje objekt služby Application Gateway, ve kterém se má upravit konfigurace front-endové IP adresy.

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

-DefaultProfile

Přihlašovací údaje, účet, tenant a předplatné používané ke komunikaci s Azure.

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

-Name

Určuje název konfigurace front-endové IP adresy, kterou tato rutina upraví.

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

-PrivateIPAddress

Určuje privátní IP adresu. Pokud je tato IP adresa zadaná, je staticky přidělená z podsítě.

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

-PublicIPAddress

Určuje veřejnou IP adresu.

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

-PublicIPAddressId

Určuje ID veřejné IP adresy.

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

-Subnet

Určuje podsíť, kterou aplikační brána používá. Tento parametr zadejte, pokud brána používá privátní IP adresu. Pokud je zadaná adresa PrivateIPAddress, měla by patřit do této podsítě. Pokud není zadaná hodnota PrivateIPAddress, jedna z IP adres z této podsítě se dynamicky vyzvedne jako front-endová IP adresa aplikační brány.

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

-SubnetId

Určuje ID podsítě. Tento parametr zadejte, pokud brána používá privátní IP adresu. Pokud je zadaný parametr PrivateIPAddress, měl by patřit do této podsítě. Pokud není zadaná hodnota PrivateIPAddress, jedna z IP adres z této podsítě se dynamicky vyzvedne jako front-endová IP adresa aplikační brány.

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

Vstupy

PSApplicationGateway

Parametry: ApplicationGateway (ByValue)

Výstupy

PSApplicationGateway