你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

Set-AzureEndpoint

修改分配给虚拟机的终结点。

注意

本文档中引用的 cmdlet 用于管理使用服务管理 API 的旧式 Azure 资源。 若要了解用于管理 Azure 资源管理器资源的 cmdlet,请参阅 Az PowerShell 模块

语法

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>]

说明

Set-AzureEndpoint cmdlet 修改分配给 Azure 虚拟机的终结点。 可以指定对未进行负载均衡的终结点的更改。

示例

示例 1:修改终结点以侦听端口

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

此命令使用 Get-AzureVM cmdlet 检索名为 VirtualMachine01 的虚拟机的配置。 该命令使用管道运算符将其传递给当前 cmdlet。 此 cmdlet 修改名为 Web 的终结点以侦听端口 443。 该命令将虚拟机对象传递给 Update-AzureVM cmdlet,该 cmdlet 可实现更改。

参数

-ACL

指定此 cmdlet 应用于终结点的访问控制列表 (ACL) 配置对象。

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

-DirectServerReturn

指定此 cmdlet 是否启用直接服务器返回。 指定要启用的$True,或指定要禁用的$False。

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

-IdleTimeoutInMinutes

指定终结点的 TCP 空闲超时期限(以分钟为单位)。

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

-InformationAction

指定此 cmdlet 如何响应信息事件。

此参数的可接受值为:

  • 继续
  • 忽略
  • 询问
  • SilentlyContinue
  • 停止
  • 暂停
Type:ActionPreference
Aliases:infa
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InformationVariable

指定信息变量。

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

-InternalLoadBalancerName

指定内部负载均衡器的名称。

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

-LoadBalancerDistribution

指定负载均衡器分发算法。 有效值是:

  • sourceIP。 两个元组相关性:源 IP、目标 IP
  • sourceIPProtocol。 三个元组相关性:源 IP、目标 IP、协议
  • 没有。 五个元组相关性:源 IP、源端口、目标 IP、目标端口、协议

默认值为 none。

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

-LocalPort

指定此终结点使用的本地专用端口。 虚拟机中的应用程序侦听此端口,以获取此终结点的服务输入请求。

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

-Name

指定终结点的名称。

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

-Profile

指定此 cmdlet 从中读取的 Azure 配置文件。 如果未指定配置文件,此 cmdlet 将从本地默认配置文件中读取。

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

-Protocol

指定终结点的协议。 有效值是:

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

-PublicPort

指定终结点使用的公共端口。

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

-VirtualIPName

指定 Azure 关联到终结点的虚拟 IP 地址的名称。 服务可以有多个虚拟 IP。 若要创建虚拟 IP,请使用 Add-AzureVirtualIP cmdlet。

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

-VM

指定终结点所属的虚拟机。

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

输出

Object