Partager via


New-AzApplicationGatewayFrontendIPConfig

Crée une configuration IP frontale pour une passerelle d’application.

Syntaxe

SetByResourceId

New-AzApplicationGatewayFrontendIPConfig
    -Name <String>
    [-PrivateIPAddress <String>]
    [-SubnetId <String>]
    [-PublicIPAddressId <String>]
    [-PrivateLinkConfigurationId <String>]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

SetByResource

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

Description

L’applet de commande New-AzApplicationGatewayFrontendIPConfig crée une configuration IP frontale pour une passerelle d’application Azure. Une passerelle d’application prend en charge deux types de configuration IP frontale :

  • Adresses IP publiques : adresses IP privées utilisant l’équilibrage de charge interne (ILB). Une passerelle d’application peut avoir au plus une adresse IP publique et une adresse IP privée. L’adresse IP publique et l’adresse IP privée doivent être ajoutées séparément en tant qu’adresses IP frontales.

Exemples

Exemple 1 : Créer une configuration IP frontale à l’aide d’un objet de ressource IP publique

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

La première commande crée un objet de ressource IP publique et le stocke dans la variable $PublicIP. La deuxième commande utilise $PublicIP pour créer une configuration IP frontale nommée FrontEndIP01 et la stocke dans la variable $FrontEnd.

Exemple 2 : Créer une adresse IP privée statique comme adresse IP frontale

$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

La première commande obtient un réseau virtuel nommé VNet01 qui appartient au groupe de ressources nommé ResourceGroup01 et le stocke dans la variable $VNet. La deuxième commande obtient une configuration de sous-réseau nommée Subnet01 à l’aide de $VNet à partir de la première commande et la stocke dans la variable $Subnet. La troisième commande crée une configuration IP frontale nommée FrontEndIP02 à l’aide de $Subnet à partir de la deuxième commande et de l’adresse IP privée 10.0.1.1, puis la stocke dans la variable $FrontEnd.

Exemple 3 : Créer une adresse IP privée dynamique en tant qu’adresse IP frontale

$VNet = Get-AzVirtualNetwork -Name "VNet01" -ResourceGroupName "ResourceGroup01"
$Subnet = Get-AzVirtualNetworkSubnetConfig -Name "Subnet01" -VirtualNetwork $VNet
$FrontEnd = New-AzApplicationGatewayFrontendIPConfig -Name "FrontendIP03" -Subnet $Subnet

La première commande obtient un réseau virtuel nommé VNet01 qui appartient au groupe de ressources nommé ResourceGroup01 et le stocke dans la variable $VNet. La deuxième commande obtient une configuration de sous-réseau nommée Subnet01 à l’aide de $VNet à partir de la première commande et la stocke dans la variable $Subnet. La troisième commande crée une configuration IP frontale nommée FrontEndIP03 à l’aide de $Subnet à partir de la deuxième commande et la stocke dans la variable $FrontEnd.

Paramètres

-DefaultProfile

Informations d’identification, compte, locataire et abonnement utilisés pour la communication avec Azure.

Propriétés du paramètre

Type:IAzureContextContainer
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:AzContext, AzureRmContext, AzureCredential

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Name

Spécifie le nom de la configuration IP frontale créée par cette applet de commande.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-PrivateIPAddress

Spécifie l’adresse IP privée que cette applet de commande associe à l’adresse IP frontale de la passerelle d’application. Cela ne peut être spécifié que si un sous-réseau est spécifié. Cette adresse IP est allouée statiquement à partir du sous-réseau.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-PrivateLinkConfiguration

PrivateLinkConfiguration

Propriétés du paramètre

Type:PSApplicationGatewayPrivateLinkConfiguration
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

SetByResource
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-PrivateLinkConfigurationId

PrivateLinkConfigurationId

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

SetByResourceId
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-PublicIPAddress

Spécifie l’objet d’adresse IP publique que cette applet de commande associe à l’adresse IP frontale de la passerelle d’application.

Propriétés du paramètre

Type:PSPublicIpAddress
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

SetByResource
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-PublicIPAddressId

Spécifie l’ID d’adresse IP publique que cette applet de commande associe à l’adresse IP frontale de la passerelle d’application.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

SetByResourceId
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Subnet

Spécifie l’objet de sous-réseau que cette applet de commande associe à l’adresse IP frontale de la passerelle d’application. Si vous spécifiez ce paramètre, cela implique que la passerelle utilise une adresse IP privée. Si le paramètre PrivateIPAddress est spécifié, il doit appartenir au sous-réseau spécifié par ce paramètre. Si PrivateIPAddress n’est pas spécifié, l’une des adresses IP de ce sous-réseau est récupérée dynamiquement comme adresse IP frontale de la passerelle d’application.

Propriétés du paramètre

Type:PSSubnet
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

SetByResource
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-SubnetId

Spécifie l’ID de sous-réseau que cette applet de commande associe à la configuration IP frontale de la passerelle d’application. Si vous spécifiez le paramètre De sous-réseau , cela implique que la passerelle utilise une adresse IP privée. Si le paramètre PrivateIPAddress est spécifié, il doit appartenir au sous-réseau spécifié par le sous-réseau. Si PrivateIPAddress n’est pas spécifié, l’une des adresses IP de ce sous-réseau est récupérée dynamiquement comme adresse IP frontale de la passerelle d’application.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

SetByResourceId
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

CommonParameters

Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.

Entrées

None

Sorties

PSApplicationGatewayFrontendIPConfiguration