New-AzApplicationGatewayFrontendIPConfig

  • Referenz
Modul:
Az.Network

Erstellt eine Front-End-IP-Konfiguration für ein Anwendungsgateway.

Syntax

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

Beschreibung

Das Cmdlet New-AzApplicationGatewayFrontendIPConfig erstellt eine Front-End-IP-Konfiguration für ein Azure-Anwendungsgateway. Ein Anwendungsgateway unterstützt zwei Arten von Front-End-IP-Konfigurationen:

  • Öffentliche IP-Adressen – Private IP-Adressen mit internem Lastenausgleich (ILB). Ein Anwendungsgateway kann höchstens eine öffentliche IP-Adresse und eine private IP-Adresse aufweisen. Die öffentliche IP-Adresse und die private IP-Adresse sollten separat als Front-End-IP-Adressen hinzugefügt werden.

Beispiele

Beispiel 1: Erstellen einer Front-End-IP-Konfiguration mithilfe eines öffentlichen IP-Ressourcenobjekts

$PublicIP = New-AzPublicIpAddress -ResourceGroupName "ResourceGroup01" -Name "PublicIP01" -location "West US" -AllocationMethod Dynamic
$FrontEnd = New-AzApplicationGatewayFrontendIPConfig -Name "FrontEndIP01" -PublicIPAddress $PublicIP

Der erste Befehl erstellt ein öffentliches IP-Ressourcenobjekt und speichert es in der $PublicIP Variablen. Der zweite Befehl verwendet $PublicIP, um eine neue Front-End-IP-Konfiguration namens FrontEndIP01 zu erstellen und in der variablen $FrontEnd zu speichern.

Beispiel 2: Erstellen einer statischen privaten IP als Front-End-IP-Adresse

$VNet = Get-AzVirtualNetwork -Name "VNet01" -ResourceGroupName "ResourceGroup01"
$Subnet = Get-AzVirtualNetworkSubnetConfig -Name "Subnet01" -VirtualNetwork $VNet
$FrontEnd = New-AzApplicationGatewayFrontendIPConfig -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 erstellt eine Front-End-IP-Konfiguration namens "FrontEndIP02" mit $Subnet aus dem zweiten Befehl und der privaten IP-Adresse 10.0.1.1 und speichert sie dann in der variablen $FrontEnd.

Beispiel 3: Erstellen einer dynamischen privaten IP als Front-End-IP-Adresse

$VNet = Get-AzVirtualNetwork -Name "VNet01" -ResourceGroupName "ResourceGroup01"
$Subnet = Get-AzVirtualNetworkSubnetConfig -Name "Subnet01" -VirtualNetwork $VNet
$FrontEnd = New-AzApplicationGatewayFrontendIPConfig -Name "FrontendIP03" -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 erstellt eine Front-End-IP-Konfiguration namens FrontEndIP03 mithilfe von $Subnet aus dem zweiten Befehl und speichert sie in der $FrontEnd Variablen.

Parameter

-DefaultProfile

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

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

-Name

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

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

-PrivateIPAddress

Gibt die private IP-Adresse an, die dieses Cmdlet der Front-End-IP-Adresse des Anwendungsgateways zuordnet. Dies kann nur angegeben werden, wenn ein Subnetz angegeben wird. Diese IP wird statisch aus dem Subnetz zugewiesen.

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

Gibt das öffentliche IP-Adressobjekt an, das dieses Cmdlet der Front-End-IP-Adresse des Anwendungsgateways zuordnet.

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

-PublicIPAddressId

Gibt die öffentliche IP-Adress-ID an, die dieses Cmdlet der Front-End-IP des Anwendungsgateways zuordnet.

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

-Subnet

Gibt das Subnetzobjekt an, das dieses Cmdlet der Front-End-IP-Adresse des Anwendungsgateways zuordnet. Wenn Sie diesen Parameter angeben, bedeutet dies, dass das Gateway eine private IP-Adresse verwendet. Wenn der Parameter "PrivateIPAddress " angegeben ist, sollte er dem durch diesen Parameter angegebenen Subnetz angehören. Wenn PrivateIPAddress nicht angegeben ist, wird eine der IP-Adressen aus diesem Subnetz dynamisch als Front-End-IP-Adresse des Anwendungsgateways aufgenommen.

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

-SubnetId

Gibt die Subnetz-ID an, die dieses Cmdlet der Front-End-IP-Konfiguration des Anwendungsgateways zuordnet. Wenn Sie den Subnetzparameter angeben, bedeutet dies, dass das Gateway eine private IP-Adresse verwendet. Wenn der Parameter "PrivateIPAddress " angegeben ist, sollte er zum subnetz gehören, das von Subnetz angegeben wird. Wenn PrivateIPAddress nicht angegeben ist, wird eine der IP-Adressen aus diesem Subnetz dynamisch als Front-End-IP-Adresse des Anwendungsgateways aufgenommen.

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

Eingaben

None

Ausgaben

PSApplicationGatewayFrontendIPConfiguration