Set-AzApplicationGatewayFrontendIPConfig

  • Referentie
Module:
Az.Network

Hiermee wijzigt u een front-end-IP-adresconfiguratie.

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

De cmdlet Set-AzApplicationGatewayFrontendIPConfig werkt een front-end-IP-configuratie bij. Een toepassingsgateway ondersteunt twee typen front-end-IP-adressen:

  • Openbare IP-adressen
  • Privé-IP-adressen waarvoor de configuratie gebruikmaakt van Interne taakverdeling (ILB) Een toepassingsgateway kan maximaal één openbaar IP-adres en één privé-IP-adres hebben. Een openbaar IP-adres en een privé-IP-adres moeten afzonderlijk worden toegevoegd als front-end-IP-adressen.

Voorbeelden

Voorbeeld 1: Een openbaar IP instellen als front-end-IP van een toepassingsgateway

$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

Met de eerste opdracht wordt een openbaar IP-adresobject gemaakt en opgeslagen in de $PublicIp variabele. Met de tweede opdracht wordt de toepassingsgateway met de naam ApplicationGateway01 die deel uitmaakt van de resourcegroep ResourceGroup01, opgeslagen in de $AppGw variabele. Met de derde opdracht wordt de front-end-IP-configuratie met de naam FrontEndIp01, voor de gateway in $AppGw, bijgewerkt met behulp van het adres dat is opgeslagen in $PublicIp.

Voorbeeld 2: Een statisch privé-IP-adres instellen als het front-end-IP-adres van een toepassingsgateway

$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

Met de eerste opdracht wordt een virtueel netwerk met de naam VNet01 dat deel uitmaakt van de resourcegroep ResourceGroup01, opgeslagen in de variabele $VNet. Met de tweede opdracht wordt een subnetconfiguratie met de naam Subnet01 opgehaald met behulp van $VNet uit de eerste opdracht en wordt deze opgeslagen in de $Subnet variabele. Met de derde opdracht wordt de toepassingsgateway met de naam ApplicationGateway01 die deel uitmaakt van de resourcegroep ResourceGroup01, opgeslagen in de $AppGw variabele. Met de vierde opdracht wordt een front-end-IP-configuratie met de naam FrontendIP02 toegevoegd met behulp van $Subnet uit de tweede opdracht en het privé-IP-adres 10.0.1.1.

Voorbeeld 3: Een dynamisch privé-IP-adres instellen als het front-end-IP-adres van een toepassingsgateway

$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

Met de eerste opdracht wordt een virtueel netwerk met de naam VNet01 dat deel uitmaakt van de resourcegroep ResourceGroup01, opgeslagen in de variabele $VNet. Met de tweede opdracht wordt een subnetconfiguratie met de naam Subnet01 opgehaald met behulp van $VNet uit de eerste opdracht en wordt deze opgeslagen in de $Subnet variabele. Met de derde opdracht wordt de toepassingsgateway met de naam ApplicationGateway01 die deel uitmaakt van de resourcegroep ResourceGroup01, opgeslagen in de $AppGw variabele. Met de vierde opdracht wordt een front-end-IP-configuratie met de naam FrontendIP02 toegevoegd met behulp van $Subnet van de tweede opdracht.

Parameters

-ApplicationGateway

Hiermee geeft u een toepassingsgatewayobject op waarin de front-end-IP-configuratie moet worden gewijzigd.

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

-DefaultProfile

De referenties, het account, de tenant en het abonnement die worden gebruikt voor communicatie met Azure.

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

-Name

Hiermee geeft u de naam van de front-end IP-configuratie die door deze cmdlet wordt gewijzigd.

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

-PrivateIPAddress

Hiermee geeft u het privé-IP-adres. Indien opgegeven, wordt dit IP-adres statisch toegewezen vanuit het subnet.

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

Hiermee geeft u het openbare IP-adres.

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

-PublicIPAddressId

Hiermee geeft u de id van het openbare IP-adres.

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

-Subnet

Hiermee geeft u het subnet op dat de toepassingsgateway gebruikt. Geef deze parameter op als de gateway een privé-IP-adres gebruikt. Als het PrivateIPAddress-adres is opgegeven, moet het deel uitmaken van dit subnet. Als PrivateIPAddress niet is opgegeven, wordt een van de IP-adressen van dit subnet dynamisch opgehaald als het front-end-IP-adres van de toepassingsgateway.

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

-SubnetId

Hiermee geeft u de subnet-id. Geef deze parameter op als de gateway een privé-IP-adres gebruikt. Als de parameter PrivateIPAddress is opgegeven, moet deze deel uitmaken van dit subnet. Als PrivateIPAddress niet is opgegeven, wordt een van de IP-adressen van dit subnet dynamisch opgehaald als het front-end-IP-adres van de toepassingsgateway.

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

Invoerwaarden

PSApplicationGateway

Uitvoerwaarden

PSApplicationGateway