Partager via

Update-AzureApplicationGateway

  • Référence
Module:
Azure

Met à jour une passerelle d’application.

Remarque

Les cmdlets mentionnées dans cette documentation servent à gérer les ressources Azure héritées qui utilisent les API Azure Service Manager (ASM). Ce module PowerShell hérité n’est pas recommandé lors de la création de ressources, car ASM est planifié pour la mise hors service. Pour plus d’informations, consultez la mise hors service d’Azure Service Manager.

Le module Az PowerShell est le module PowerShell recommandé pour la gestion des ressources Azure Resource Manager (ARM) avec PowerShell.

Syntaxe

Update-AzureApplicationGateway
      -Name <String>
      [-VnetName <String>]
      [-Subnets <System.Collections.Generic.List`1[System.String]>]
      [-InstanceCount <UInt32>]
      [-GatewaySize <String>]
      [-Description <String>]
      [-Profile <AzureSMProfile>]
      [<CommonParameters>]

Description

L’applet de commande Update-AzureApplicationGateway met à jour une passerelle d’application existante.

Exemples

Exemple 1 : Modifier une passerelle Application Gateway à l’aide de son nom

PS C:\> Stop-AzureApplicationGateway -Name "ApplicationGateway06"
PS C:\> Update-AzureApplicationGateway -Name "ApplicationGateway06" -VnetName "VirutalNetwork18" -Subnets @("Subnet05", "Subnet06")

La première commande arrête la passerelle Application Gateway nommée ApplicationGateway06. Une passerelle d’application doit être arrêtée avant de pouvoir modifier le réseau virtuel ou les sous-réseaux.

La deuxième commande modifie le sous-réseau virtuel et les sous-réseaux de la passerelle d’application nommée ApplicationGateway06.

Exemple 2 : Modifier des propriétés supplémentaires d’une passerelle d’application

PS C:\> Update-AzureApplicationGateway -Name "ApplicationGateway06" -InstanceCount 2 -GatewaySize "Large" -Description "Updated application gateway"

Cette commande modifie le nombre d’instances, la taille de passerelle et la description de la passerelle d’application nommée ApplicationGateway06. Cette commande ne modifie pas le réseau virtuel ou les sous-réseaux pour la passerelle d’application. Par conséquent, vous n’avez pas besoin d’arrêter la passerelle Application Gateway avant d’exécuter cette commande.

Exemple 3 : Modifier une passerelle Application Gateway à l’aide du pipeline

PS C:\> $ApplicationGateway = Get-AzureApplicationGateway -Name "ApplicationGateway06"
PS C:\> $ApplicationGateway.GatewaySize = "Medium"
PS C:\> $ApplicationGateway | Update-AzureApplicationGateway

La première commande obtient la passerelle d’application nommée ApplicationGateway06 à l’aide de l’applet de commande Get-AzureApplicationGateway . La commande la stocke dans la variable $ApplicationGateway.

La deuxième commande affecte à la propriété GatewaySize la valeur Medium.

La commande finale transmet les $ApplicationGateway mises à jour à l’applet de commande actuelle.

Paramètres

-Description

Spécifie une description que cette applet de commande affecte à la passerelle d’application.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-GatewaySize

Spécifie la taille que cette applet de commande affecte à la passerelle d’application. Les valeurs valides sont :

  • Petite
  • Moyenne
  • grand
Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-InstanceCount

Spécifie le nombre d’instances que cette applet de commande attribue à la passerelle d’application.

Type:UInt32
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-Name

Spécifie le nom de la passerelle d’application mise à jour par cette applet de commande.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-Profile

Spécifie le profil Azure à partir duquel cette applet de commande lit. Si vous ne spécifiez pas de profil, cette applet de commande lit le profil par défaut local.

Type:AzureSMProfile
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Subnets

Spécifie un tableau de sous-réseaux dans lequel cette applet de commande déploie la passerelle Application Gateway.

Vous ne pouvez pas mettre à jour les sous-réseaux pendant l’exécution de la passerelle Application Gateway. Pour arrêter la passerelle d’application, utilisez l’applet de commande Stop-AzureApplicationGateway.

Type:List<T>[String]
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-VnetName

Spécifie le réseau virtuel dans lequel cette applet de commande déploie la passerelle d’application.

Vous ne pouvez pas mettre à jour un réseau virtuel pendant l’exécution de la passerelle Application Gateway. Pour arrêter la passerelle Application Gateway, utilisez Stop-AzureApplicationGateway.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

Entrées

String

Sorties

Microsoft.WindowsAzure.Management.ApplicationGateway.Models.ApplicationGatewayOperationResponse