Dela via


Set-AzureRmApplicationGatewayFrontendIPConfig

Ändrar en ip-adresskonfiguration på klientsidan.

Varning

AzureRM PowerShell-modulen är officiellt inaktuell från och med den 29 februari 2024. Användare rekommenderas att migrera från AzureRM till Az PowerShell-modulen för att säkerställa fortsatt support och uppdateringar.

Även om AzureRM-modulen fortfarande kan fungera, underhålls den inte längre eller stöds, vilket gör att användaren kan välja och riskera fortsatt användning. Se våra migreringsresurser för vägledning om övergången till Az-modulen.

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

Cmdleten Set-AzureRmApplicationGatewayFrontendIPConfig uppdaterar en IP-konfiguration på klientsidan. En programgateway har stöd för två typer av IP-adresser på klientsidan:

  • Offentliga IP-adresser
  • Privata IP-adresser för vilka konfigurationen använder intern belastningsutjämning (ILB) En programgateway kan ha högst en offentlig IP-adress och en privat IP-adress. En offentlig IP-adress och en privat IP-adress ska läggas till separat som IP-adresser på klientsidan.

Exempel

Exempel 1: Ange en offentlig IP-adress som klientdels-IP för en programgateway

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

Det första kommandot skapar ett offentligt IP-adressobjekt och lagrar det i variabeln $PublicIp. Det andra kommandot hämtar programgatewayen med namnet ApplicationGateway01 som tillhör resursgruppen med namnet ResourceGroup01 och lagrar den i variabeln $AppGw. Det tredje kommandot uppdaterar klientdelens IP-konfiguration med namnet FrontEndIp01 för gatewayen i $AppGw med hjälp av adressen som lagras i $PublicIp.

Exempel 2: Ange en statisk privat IP-adress som klientdels-IP för en programgateway

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

Det första kommandot hämtar ett virtuellt nätverk med namnet VNet01 som tillhör resursgruppen med namnet ResourceGroup01 och lagrar det i variabeln $VNet. Det andra kommandot hämtar en undernätskonfiguration med namnet Subnet01 med $VNet från det första kommandot och lagrar den i variabeln $Subnet. Det tredje kommandot hämtar programgatewayen med namnet ApplicationGateway01 som tillhör resursgruppen med namnet ResourceGroup01 och lagrar den i variabeln $AppGw. Det fjärde kommandot lägger till en IP-konfiguration för klientdelen med namnet FrontendIP02 med $Subnet från det andra kommandot och den privata IP-adressen 10.0.1.1.

Exempel 3: Ange en dynamisk privat IP-adress som klientdels-IP för en programgateway

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

Det första kommandot hämtar ett virtuellt nätverk med namnet VNet01 som tillhör resursgruppen med namnet ResourceGroup01 och lagrar det i variabeln $VNet. Det andra kommandot hämtar en undernätskonfiguration med namnet Subnet01 med $VNet från det första kommandot och lagrar den i variabeln $Subnet. Det tredje kommandot hämtar programgatewayen med namnet ApplicationGateway01 som tillhör resursgruppen med namnet ResourceGroup01 och lagrar den i variabeln $AppGw. Det fjärde kommandot lägger till en IP-konfiguration på klientsidan med namnet FrontendIP02 med $Subnet från det andra kommandot.

Parametrar

-ApplicationGateway

Anger ett programgatewayobjekt där ip-konfigurationen för klientdelen ska ändras.

Typ:PSApplicationGateway
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-DefaultProfile

Autentiseringsuppgifter, konto, klientorganisation och prenumeration som används för kommunikation med Azure.

Typ:IAzureContextContainer
Alias:AzureRmContext, AzureCredential
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Name

Anger namnet på ip-konfigurationen för klientdelen som den här cmdleten ändrar.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-PrivateIPAddress

Anger den privata IP-adressen. Om den här IP-adressen anges allokeras den statiskt från undernätet.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-PublicIPAddress

Anger den offentliga IP-adressen.

Typ:PSPublicIpAddress
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-PublicIPAddressId

Anger ID för den offentliga IP-adressen.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Subnet

Anger det undernät som programgatewayen använder. Ange den här parametern om gatewayen använder en privat IP-adress. Om privateIPAddress-adressen har angetts ska den tillhöra det här undernätet. Om PrivateIPAddress inte anges hämtas en av IP-adresserna från det här undernätet dynamiskt som klientdels-IP-adress för programgatewayen.

Typ:PSSubnet
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-SubnetId

Anger undernäts-ID. Ange den här parametern om gatewayen använder en privat IP-adress. Om parametern PrivateIPAddress har angetts ska den tillhöra det här undernätet. Om PrivateIPAddress inte anges hämtas en av IP-adresserna från det här undernätet dynamiskt som klientdels-IP-adress för programgatewayen.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

Indata

PSApplicationGateway

Parametrar: ApplicationGateway (ByValue)

Utdata

PSApplicationGateway