Udostępnij za pośrednictwem

Set-AzureRmApplicationGatewayFrontendIPConfig

  • Odwołanie
Moduł:
AzureRM.Network

Modyfikuje konfigurację adresu IP frontonu.

Ostrzeżenie

Moduł AzureRM PowerShell został oficjalnie przestarzały od 29 lutego 2024 r. Zaleca się migrowanie użytkowników z modułu AzureRM do modułu Az programu PowerShell w celu zapewnienia ciągłej obsługi i aktualizacji.

Mimo że moduł AzureRM może nadal działać, nie jest już utrzymywany ani obsługiwany, umieszczając wszelkie dalsze zastosowania według uznania i ryzyka użytkownika. Zapoznaj się z naszymi zasobami migracji, aby uzyskać wskazówki dotyczące przejścia do modułu Az.

Składnia

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

Opis

Polecenie cmdlet Set-AzureRmApplicationGatewayFrontendIPConfig 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

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

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

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

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

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

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.

Typ:PSApplicationGateway
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-DefaultProfile

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

Typ:IAzureContextContainer
Aliasy:AzureRmContext, AzureCredential
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Name

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

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-PrivateIPAddress

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

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-PublicIPAddress

Określa publiczny adres IP.

Typ:PSPublicIpAddress
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-PublicIPAddressId

Określa identyfikator publicznego adresu IP.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych: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.

Typ:PSSubnet
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych: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.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

Dane wejściowe

PSApplicationGateway

Parametry: ApplicationGateway (ByValue)

Dane wyjściowe

PSApplicationGateway