Add-AzureRmApplicationGatewayFrontendIPConfig

  • Referens
Modul:
AzureRM.Network

Lägger till en IP-konfiguration på klientsidan till en programgateway.

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

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

Description

Cmdleten Add-AzureRmApplicationGatewayFrontendIPConfig lägger till en IP-konfiguration på klientsidan till en programgateway. En programgateway stöder två typer av IP-konfigurationer på klientsidan:

  • Offentliga IP-adresser
  • Privata IP-adresser med intern belastningsutjämning (ILB) En programgateway kan ha högst en offentlig IP-adress och en privat IP-adress. Lägg till den offentliga IP-adressen och den privata IP-adressen som separata ip-adresser på klientsidan.

Exempel

Exempel 1: Lägg till en offentlig IP-adress som klientdels-IP-adress

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 = Add-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 lägger till ip-konfigurationen för klientdelen med namnet FrontEndIp01 för gatewayen i $AppGw med hjälp av adressen som lagras i $PublicIp.

Exempel 2: Lägg till en statisk privat IP-adress som klientdels-IP-adress

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 = Add-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: Lägg till en dynamisk privat IP-adress som klientdels-IP-adress

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 = Add-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 den programgateway som den här cmdleten lägger till en IP-konfiguration på klientsidan.

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 ska läggas till.

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

-PrivateIPAddress

Anger den privata IP-adress som ska läggas till som en klientdels-IP för programgatewayen. 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-adress som den här cmdleten lägger till som en klientdels-IP-adress för programgatewayen.

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-adress som den här cmdleten lägger till som en klientdels-IP-adress för programgatewayen.

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

-Subnet

Anger det undernät som den här cmdleten lägger till som IP-konfiguration på klientsidan. Om du anger den här parametern innebär det att programgatewayen stöder en privat IP-baserad konfiguration. 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:PSSubnet
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-SubnetId

Anger det undernäts-ID som den här cmdleten lägger till som IP-konfiguration för klientdelen. Att skicka undernät innebär privat IP. Om parametern PrivateIPAddresss anges ska den tillhöra det här undernätet. Annars hämtas en av IP-adresserna från det här undernätet dynamiskt som klientdels-IP 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