Set-AzureEndpoint

Référence

Module:: Azure

Modifie un point de terminaison affecté à 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

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
Default value:	None
Required:	False
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

-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:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Name

Spécifie le nom du point de terminaison.

Type:	String
Position:	0
Default value:	None
Required:	True
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 :

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

-PublicPort

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

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