Partager via

Set-AzureEndpoint

  • Référence
Module:
Azure

Modifie un point de terminaison affecté à une machine virtuelle.

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

Set-AzureEndpoint
   [-Name] <String>
   [[-Protocol] <String>]
   [[-LocalPort] <Int32>]
   [-PublicPort <Int32>]
   [-DirectServerReturn <Boolean>]
   [-ACL <NetworkAclObject>]
   [-InternalLoadBalancerName <String>]
   [-IdleTimeoutInMinutes <Int32>]
   [-LoadBalancerDistribution <String>]
   [-VirtualIPName <String>]
   -VM <IPersistentVM>
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]

Description

L’applet de commande Set-AzureEndpoint modifie un point de terminaison affecté à une machine virtuelle Azure. Vous pouvez spécifier des modifications apportées à un point de terminaison qui n’est pas équilibré en charge.

Exemples

Exemple 1 : Modifier un point de terminaison pour écouter sur un port

PS C:\> Get-AzureVM -ServiceName "ContosoService" -Name "VirutalMachine01" | Set-AzureEndpoint -Name "Web" -PublicPort 443 -LocalPort 443 -Protocol tcp | Update-AzureVM

Cette commande récupère la configuration d’une machine virtuelle nommée VirtualMachine01 à l’aide de l’applet de commande Get-AzureVM . La commande la transmet à l’applet de commande actuelle à l’aide de l’opérateur de pipeline. Cette applet de commande modifie le point de terminaison nommé Web pour écouter sur le port 443. La commande transmet l’objet de machine virtuelle à l’applet de commande Update-AzureVM , qui implémente vos modifications.

Paramètres

-ACL

Spécifie un objet de configuration de liste de contrôle d’accès (ACL) que cette applet de commande s’applique au point de terminaison.

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

-DirectServerReturn

Spécifie si cette applet de commande active le retour direct du serveur. Spécifiez $True pour activer ou $False à désactiver.

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

-IdleTimeoutInMinutes

Spécifie le délai d’inactivité TCP, en minutes, pour le point de terminaison.

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

-InformationAction

Spécifie la façon dont cette applet de commande répond à un événement d’information.

Les valeurs valides pour ce paramètre sont :

  • Continuer
  • Ignorer
  • Demander
  • SilentlyContinue
  • Stop
  • Suspendre
Type:ActionPreference
Alias:infa
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-InformationVariable

Spécifie une variable d’informations.

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

-InternalLoadBalancerName

Spécifie le nom de l’équilibreur de charge interne.

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

-LoadBalancerDistribution

Spécifie l’algorithme de distribution de l’équilibreur de charge. Les valeurs valides sont :

  • sourceIP. Une affinité de deux tuples : adresse IP source, adresse IP de destination
  • sourceIPProtocol. Une affinité de trois tuples : adresse IP source, adresse IP de destination, protocole
  • aucun. Une affinité de cinq tuples : adresse IP source, port source, adresse IP de destination, port de destination, protocole

La valeur par défaut n’est pas.

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

-LocalPort

Spécifie le port local, privé, utilisé par ce point de terminaison. Les applications au sein de la machine virtuelle écoutent sur ce port pour les demandes d’entrée de service pour ce point de terminaison.

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

-Name

Spécifie le nom du point de terminaison.

Type:String
Position:0
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
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

-Protocol

Spécifie le protocole du point de terminaison. Les valeurs valides sont :

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

-PublicPort

Spécifie le port public utilisé par le point de terminaison.

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

-VirtualIPName

Spécifie le nom d’une adresse IP virtuelle associée par Azure au point de terminaison. Votre service peut avoir plusieurs adresses IP virtuelles. Pour créer des adresses IP virtuelles, utilisez l’applet de commande Add-AzureVirtualIP .

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

-VM

Spécifie la machine virtuelle à laquelle appartient le point de terminaison.

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

Sorties

Object