Add-AzureEndpoint

  • Référence
Module:
Azure

Ajoute un point de terminaison à une machine virtuelle.

Notes

Les cmdlets mentionnées dans cette documentation servent à gérer les ressources Azure héritées qui utilisent les API Gestion des services. Pour ce qui est des cmdlets permettant de gérer des ressources Azure Resource Manager, consultez le Module Az PowerShell.

Syntax

Add-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>]
Add-AzureEndpoint
   [-Name] <String>
   [-Protocol] <String>
   [-LocalPort] <Int32>
   [-PublicPort <Int32>]
   [-DirectServerReturn <Boolean>]
   [-ACL <NetworkAclObject>]
   -LBSetName <String>
   [-NoProbe]
   [-InternalLoadBalancerName <String>]
   [-IdleTimeoutInMinutes <Int32>]
   [-LoadBalancerDistribution <String>]
   [-VirtualIPName <String>]
   -VM <IPersistentVM>
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]
Add-AzureEndpoint
   [-Name] <String>
   [-Protocol] <String>
   [-LocalPort] <Int32>
   [-PublicPort <Int32>]
   [-DirectServerReturn <Boolean>]
   [-ACL <NetworkAclObject>]
   -LBSetName <String>
   [-DefaultProbe]
   [-InternalLoadBalancerName <String>]
   [-IdleTimeoutInMinutes <Int32>]
   [-LoadBalancerDistribution <String>]
   [-VirtualIPName <String>]
   -VM <IPersistentVM>
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]
Add-AzureEndpoint
   [-Name] <String>
   [-Protocol] <String>
   [-LocalPort] <Int32>
   [-PublicPort <Int32>]
   [-DirectServerReturn <Boolean>]
   [-ACL <NetworkAclObject>]
   -LBSetName <String>
   -ProbePort <Int32>
   -ProbeProtocol <String>
   [-ProbePath <String>]
   [-ProbeIntervalInSeconds <Int32>]
   [-ProbeTimeoutInSeconds <Int32>]
   [-InternalLoadBalancerName <String>]
   [-IdleTimeoutInMinutes <Int32>]
   [-LoadBalancerDistribution <String>]
   [-VirtualIPName <String>]
   -VM <IPersistentVM>
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]

Description

L’applet de commande Add-AzureEndpoint ajoute un point de terminaison à un objet de machine virtuelle Azure.

Exemples

Exemple 1 : Ajouter un point de terminaison

PS C:\> Get-AzureVM -ServiceName "ContosoService" -Name "VirutalMachine01" | Add-AzureEndpoint -Name "HttpIn" -Protocol "tcp" -PublicPort 80 -LocalPort 8080 | 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 ajoute un point de terminaison nommé HttpIn. Le point de terminaison a un port public 80 et un port local 8080. La commande transmet l’objet de machine virtuelle à l’applet de commande Update-AzureVM , qui implémente vos modifications.

Exemple 2 : Ajouter un point de terminaison appartenant à un groupe à charge équilibrée

PS C:\> Get-AzureVM -ServiceName "LoadBalancedService" -Name "VirtualMachine12" | Add-AzureEndpoint -Name "HttpIn" -Protocol "tcp" -PublicPort 80 -LocalPort 8080 -LBSetName "WebFarm" -ProbePort 80 -ProbeProtocol "http" -ProbePath '/' | Update-AzureVM

Cette commande récupère la configuration d’une machine virtuelle nommée VirtualMachine07. L’applet de commande actuelle ajoute un point de terminaison nommé HttpIn. Le point de terminaison a un port public 80 et un port local 8080. Le point de terminaison appartient au groupe à charge équilibrée partagé nommé WebFarm. Une sonde HTTP sur le port 80 avec un chemin d’accès « / » surveille la disponibilité du point de terminaison. La commande implémente vos modifications.

Exemple 3 : Associer une adresse IP virtuelle à un point de terminaison

PS C:\> Get-AzureVM -ServiceName "ContosoService" -Name "VirtualMachine25" | Add-AzureEndpoint -Name "HttpIn" -Protocol "tcp" -LocalPort 8080 -PublicPort 80 -VirtualIPName "ContosoVip11" | Update-AzureVM

Cette commande récupère la configuration d’une machine virtuelle nommée VirtualMachine25. L’applet de commande actuelle ajoute un point de terminaison nommé HttpIn. Le point de terminaison a un port public 80 et un port local 8080. Cette commande associe une adresse IP virtuelle au point de terminaison. La commande implémente vos modifications.

Paramètres

-ACL

Spécifie un objet de configuration de liste de contrôle d’accès (ACL) pour le point de terminaison.

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

-DefaultProbe

Indique que cette applet de commande utilise le paramètre de sonde par défaut.

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-IdleTimeoutInMinutes

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

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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
  • Renseignez-vous
  • SilentlyContinue
  • Arrêter
  • Suspendre
Type:ActionPreference
Aliases:infa
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InformationVariable

Spécifie une variable d’informations.

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

-InternalLoadBalancerName

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

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

-LBSetName

Spécifie le nom du jeu d’équilibreur de charge pour le point de terminaison.

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

-LoadBalancerDistribution

Spécifie l’algorithme de distribution de l’équilibreur de charge. Les valeurs autorisées 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
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Name

Spécifie un nom pour le point de terminaison.

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

-NoProbe

Indique que cette applet de commande n’utilise aucun paramètre de sonde.

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

-ProbeIntervalInSeconds

Spécifie l’intervalle d’interrogation de la sonde, en secondes, pour le point de terminaison.

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

-ProbePath

Spécifie le chemin relatif de la sonde HTTP.

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

-ProbePort

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

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

-ProbeProtocol

Spécifie le protocole de port. Les valeurs autorisées sont :

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

-ProbeTimeoutInSeconds

Spécifie la période d’expiration du délai d’interrogation de la sonde en secondes.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Protocol

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

  • tcp
  • udp
Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-PublicPort

Spécifie le port public utilisé par le point de terminaison. Si vous ne spécifiez pas de valeur, Azure affecte un port disponible.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-VM

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

Type:IPersistentVM
Aliases:InputObject
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

Sorties

Object