Set-AzApplicationGatewayFrontendIPConfig

  • Referens
Modul:
Az.Network

Ändrar en ip-adresskonfiguration på klientsidan.

Syntax

Set-AzApplicationGatewayFrontendIPConfig
   -ApplicationGateway <PSApplicationGateway>
   -Name <String>
   [-PrivateIPAddress <String>]
   [-SubnetId <String>]
   [-PublicIPAddressId <String>]
   [-PrivateLinkConfigurationId <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Set-AzApplicationGatewayFrontendIPConfig
   -ApplicationGateway <PSApplicationGateway>
   -Name <String>
   [-PrivateIPAddress <String>]
   [-Subnet <PSSubnet>]
   [-PublicIPAddress <PSPublicIpAddress>]
   [-PrivateLinkConfiguration <PSApplicationGatewayPrivateLinkConfiguration>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Description

Cmdleten Set-AzApplicationGatewayFrontendIPConfig 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

$PublicIp = New-AzPublicIpAddress -ResourceGroupName "ResourceGroup01" -Name "PublicIp01" -location "West US" -AllocationMethod Dynamic
$AppGw = Get-AzApplicationGateway -Name "ApplicationGateway01" -ResourceGroupName "ResourceGroup01"
$AppGw = Set-AzApplicationGatewayFrontendIPConfig -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

$VNet = Get-AzVirtualNetwork -Name "VNet01" -ResourceGroupName "ResourceGroup01"
$Subnet = Get-AzVirtualNetworkSubnetConfig -Name "Subnet01" -VirtualNetwork $VNet
$AppGw = Get-AzApplicationGateway -Name "ApplicationGateway01" -ResourceGroupName "ResourceGroup01"
$AppGw = Set-AzApplicationGatewayFrontendIPConfig -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

$VNet = Get-AzVirtualNetwork -Name "VNet01" -ResourceGroupName "ResourceGroup01"
$Subnet = Get-AzVirtualNetworkSubnetConfig -Name "Subnet01" -VirtualNetwork $VNet
$AppGw = Get-AzApplicationGateway -Name "ApplicationGateway01" -ResourceGroupName "ResourceGroup01"
$AppGw = Set-AzApplicationGatewayFrontendIPConfig -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.

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

-DefaultProfile

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

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

-Name

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

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

-PrivateIPAddress

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

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

-PrivateLinkConfiguration

PrivateLinkConfiguration

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

-PrivateLinkConfigurationId

PrivateLinkConfigurationId

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

-PublicIPAddress

Anger den offentliga IP-adressen.

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

-PublicIPAddressId

Anger ID för den offentliga IP-adressen.

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

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

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

Indata

PSApplicationGateway

Utdata

PSApplicationGateway