Share via

Set-AzApplicationGatewayFrontendIPConfig

  • Odwołanie
Moduł:
Az.Network

Modyfikuje konfigurację adresu IP frontonu.

Składnia

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>]

Opis

Polecenie cmdlet Set-AzApplicationGatewayFrontendIPConfig aktualizuje konfigurację adresu IP frontonu. Brama aplikacji obsługuje dwa typy adresów IP frontonu:

  • Publiczne adresy IP
  • Prywatne adresy IP, dla których konfiguracja używa wewnętrznego równoważenia obciążenia (ILB), brama aplikacji może mieć co najwyżej jeden publiczny adres IP i jeden prywatny adres IP. Publiczny adres IP i prywatny adres IP należy dodać oddzielnie jako adresy IP frontonu.

Przykłady

Przykład 1. Ustawianie publicznego adresu IP jako adresu IP frontonu bramy aplikacji

$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

Pierwsze polecenie tworzy obiekt publicznego adresu IP i przechowuje go w zmiennej $PublicIp. Drugie polecenie pobiera bramę aplikacji o nazwie ApplicationGateway01, która należy do grupy zasobów o nazwie ResourceGroup01 i przechowuje ją w zmiennej $AppGw. Trzecie polecenie aktualizuje konfigurację adresu IP frontonu o nazwie FrontEndIp01 dla bramy w $AppGw przy użyciu adresu przechowywanego w $PublicIp.

Przykład 2. Ustawianie statycznego prywatnego adresu IP jako adresu IP frontonu bramy aplikacji

$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

Pierwsze polecenie pobiera sieć wirtualną o nazwie VNet01 należącą do grupy zasobów o nazwie ResourceGroup01 i przechowuje ją w zmiennej $VNet. Drugie polecenie pobiera konfigurację podsieci o nazwie Subnet01 przy użyciu $VNet z pierwszego polecenia i zapisuje ją w zmiennej $Subnet. Trzecie polecenie pobiera bramę aplikacji o nazwie ApplicationGateway01, która należy do grupy zasobów o nazwie ResourceGroup01 i przechowuje ją w zmiennej $AppGw. Czwarte polecenie dodaje konfigurację adresu IP frontonu o nazwie FrontendIP02 przy użyciu $Subnet z drugiego polecenia i prywatnego adresu IP 10.0.1.1.

Przykład 3. Ustawianie dynamicznego prywatnego adresu IP jako adresu IP frontonu bramy aplikacji

$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

Pierwsze polecenie pobiera sieć wirtualną o nazwie VNet01 należącą do grupy zasobów o nazwie ResourceGroup01 i przechowuje ją w zmiennej $VNet. Drugie polecenie pobiera konfigurację podsieci o nazwie Subnet01 przy użyciu $VNet z pierwszego polecenia i zapisuje ją w zmiennej $Subnet. Trzecie polecenie pobiera bramę aplikacji o nazwie ApplicationGateway01, która należy do grupy zasobów o nazwie ResourceGroup01 i przechowuje ją w zmiennej $AppGw. Czwarte polecenie dodaje konfigurację adresu IP frontonu o nazwie FrontendIP02 przy użyciu $Subnet z drugiego polecenia.

Parametry

-ApplicationGateway

Określa obiekt bramy aplikacji, w którym ma być modyfikowana konfiguracja adresu IP frontonu.

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

-DefaultProfile

Poświadczenia, konto, dzierżawa i subskrypcja używane do komunikacji z platformą Azure.

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

-Name

Określa nazwę konfiguracji adresu IP frontonu, którą modyfikuje to polecenie cmdlet.

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

-PrivateIPAddress

Określa prywatny adres IP. Jeśli zostanie określony, ten adres IP jest statycznie przydzielany z podsieci.

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

Określa publiczny adres IP.

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

-PublicIPAddressId

Określa identyfikator publicznego adresu IP.

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

-Subnet

Określa podsieć używaną przez bramę aplikacji. Określ ten parametr, jeśli brama używa prywatnego adresu IP. Jeśli określono adres PrivateIPAddress, powinien należeć do tej podsieci. Jeśli parametr PrivateIPAddress nie jest określony, jeden z adresów IP z tej podsieci jest dynamicznie pobierany jako adres IP frontonu bramy aplikacji.

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

-SubnetId

Określa identyfikator podsieci. Określ ten parametr, jeśli brama używa prywatnego adresu IP. Jeśli określono parametr PrivateIPAddress, powinien należeć do tej podsieci. Jeśli parametr PrivateIPAddress nie jest określony, jeden z adresów IP z tej podsieci jest dynamicznie pobierany jako adres IP frontonu bramy aplikacji.

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

Dane wejściowe

PSApplicationGateway

Dane wyjściowe

PSApplicationGateway