Set-AzApplicationGatewayFrontendIPConfig

Modul:
Az.Network Module

Ändert eine Front-End-IP-Adresskonfiguration.

Syntax

SetByResourceId 

Set-AzApplicationGatewayFrontendIPConfig
    -ApplicationGateway <PSApplicationGateway>
    -Name <String>
    [-PrivateIPAddress <String>]
    [-SubnetId <String>]
    [-PublicIPAddressId <String>]
    [-PrivateLinkConfigurationId <String>]
    [-DefaultProfile <IAzureContextContainer>]
    [-AcquirePolicyToken]
    [-ChangeReference <String>]
    [<CommonParameters>]

SetByResource 

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

Beschreibung

Das Cmdlet Set-AzApplicationGatewayFrontendIPConfig aktualisiert eine Front-End-IP-Konfiguration. Ein Anwendungsgateway unterstützt zwei Arten von Front-End-IP-Adressen:

  • Öffentliche IP-Adressen
  • Private IP-Adressen, für die die Konfiguration den internen Lastenausgleich (Internal Load Balancing, ILB) verwendet. Ein Anwendungsgateway kann höchstens eine öffentliche IP-Adresse und eine private IP-Adresse aufweisen. Eine öffentliche IP-Adresse und eine private IP-Adresse sollten separat als Front-End-IP-Adressen hinzugefügt werden.

Beispiele

Beispiel 1: Festlegen einer öffentlichen IP als Front-End-IP eines Anwendungsgateways

$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

Der erste Befehl erstellt ein öffentliches IP-Adressobjekt und speichert es in der $PublicIp Variablen. Der zweite Befehl ruft das Anwendungsgateway01 ab, das zur Ressourcengruppe "ResourceGroup01" gehört, und speichert es in der $AppGw Variablen. Der dritte Befehl aktualisiert die Front-End-IP-Konfiguration mit dem Namen FrontEndIp01 für das Gateway in $AppGw unter Verwendung der in $PublicIp gespeicherten Adresse.

Beispiel 2: Festlegen einer statischen privaten IP als Front-End-IP eines Anwendungsgateways

$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

Der erste Befehl ruft ein virtuelles Netzwerk namens VNet01 ab, das zur Ressourcengruppe "ResourceGroup01" gehört, und speichert es in der $VNet Variablen. Der zweite Befehl ruft eine Subnetzkonfiguration namens Subnetz01 mithilfe von $VNet aus dem ersten Befehl ab und speichert sie in der variablen $Subnet. Der dritte Befehl ruft das Anwendungsgateway01 ab, das zur Ressourcengruppe "ResourceGroup01" gehört, und speichert es in der variablen $AppGw. Der vierte Befehl fügt eine Front-End-IP-Konfiguration namens FrontendIP02 mithilfe von $Subnet aus dem zweiten Befehl und der privaten IP-Adresse 10.0.1.1 hinzu.

Beispiel 3: Festlegen einer dynamischen privaten IP als Front-End-IP eines Anwendungsgateways

$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

Der erste Befehl ruft ein virtuelles Netzwerk namens VNet01 ab, das zur Ressourcengruppe "ResourceGroup01" gehört, und speichert es in der $VNet Variablen. Der zweite Befehl ruft eine Subnetzkonfiguration namens Subnetz01 mithilfe von $VNet aus dem ersten Befehl ab und speichert sie in der variablen $Subnet. Der dritte Befehl ruft das Anwendungsgateway01 ab, das zur Ressourcengruppe "ResourceGroup01" gehört, und speichert es in der variablen $AppGw. Der vierte Befehl fügt eine Front-End-IP-Konfiguration namens FrontendIP02 mithilfe von $Subnet aus dem zweiten Befehl hinzu.

Parameter

-AcquirePolicyToken

Rufen Sie automatisch ein Azure Policy Token für diesen Ressourcenvorgang ab.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-ApplicationGateway

Gibt ein Anwendungsgatewayobjekt an, in dem die Front-End-IP-Konfiguration geändert werden soll.

Parametereigenschaften

Typ:PSApplicationGateway
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:True
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-ChangeReference

Die Änderungsreferenzressourcen-ID für diesen Ressourcenvorgang.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-DefaultProfile

Die Anmeldeinformationen, Konten, Mandanten und Abonnements, die für die Kommunikation mit Azure verwendet werden.

Parametereigenschaften

Typ:IAzureContextContainer
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:AzContext, AzureRmContext, AzureCredential

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Name

Gibt den Namen der Front-End-IP-Konfiguration an, die dieses Cmdlet ändert.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-PrivateIPAddress

Gibt die private IP-Adresse an. Wenn angegeben, wird diese IP statisch aus dem Subnetz zugeordnet.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-PrivateLinkConfiguration

PrivateLink-Konfiguration

Parametereigenschaften

Typ:PSApplicationGatewayPrivateLinkConfiguration
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

SetByResource
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-PrivateLinkConfigurationId

PrivateLinkConfigurationId

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

SetByResourceId
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-PublicIPAddress

Gibt die öffentliche IP-Adresse an.

Parametereigenschaften

Typ:PSPublicIpAddress
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

SetByResource
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-PublicIPAddressId

Gibt die ID der öffentlichen IP-Adresse an.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

SetByResourceId
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Subnet

Gibt das Subnetz an, das vom Anwendungsgateway verwendet wird. Geben Sie diesen Parameter an, wenn das Gateway eine private IP-Adresse verwendet. Wenn die PrivateIPAddress-Adresse angegeben ist, sollte sie zu diesem Subnetz gehören. Wenn PrivateIPAddress nicht angegeben ist, wird eine der IP-Adressen aus diesem Subnetz dynamisch als Front-End-IP-Adresse des Anwendungsgateways aufgenommen.

Parametereigenschaften

Typ:PSSubnet
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

SetByResource
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-SubnetId

Gibt die Subnetz-ID an. Geben Sie diesen Parameter an, wenn das Gateway eine private IP-Adresse verwendet. Wenn der Parameter "PrivateIPAddress" angegeben ist, sollte er zu diesem Subnetz gehören. Wenn PrivateIPAddress nicht angegeben ist, wird eine der IP-Adressen aus diesem Subnetz dynamisch als Front-End-IP-Adresse des Anwendungsgateways aufgenommen.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

SetByResourceId
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.

Eingaben

PSApplicationGateway

Ausgaben

PSApplicationGateway