Set-AzureRmApplicationGatewayFrontendIPConfig
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.
Syntaxe
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.
Typ: | PSApplicationGateway |
Position: | Named |
Default value: | None |
Vyžadováno: | True |
Přijmout vstup kanálu: | True |
Přijmout zástupné znaky: | False |
-DefaultProfile
Přihlašovací údaje, účet, tenant a předplatné používané ke komunikaci s Azure.
Typ: | IAzureContextContainer |
Aliasy: | AzureRmContext, AzureCredential |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-Name
Určuje název konfigurace front-endové IP adresy, kterou tato rutina upraví.
Typ: | String |
Position: | Named |
Default value: | None |
Vyžadováno: | True |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-PrivateIPAddress
Určuje privátní IP adresu. Pokud je tato IP adresa zadaná, je staticky přidělená z podsítě.
Typ: | String |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-PublicIPAddress
Určuje veřejnou IP adresu.
Typ: | PSPublicIpAddress |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-PublicIPAddressId
Určuje ID veřejné IP adresy.
Typ: | String |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | 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.
Typ: | PSSubnet |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | 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.
Typ: | String |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
Vstupy
Parametry: ApplicationGateway (ByValue)