你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
Add-AzureEndpoint
将终结点添加到虚拟机。
注意
本文档中引用的 cmdlet 用于管理使用 Azure Service Manager (ASM) API 的旧 Azure 资源。 创建新的资源时,不建议使用此旧版 PowerShell 模块,因为 ASM 计划停用。 有关详细信息,请参阅 Azure Service Manager 停用。
Az PowerShell 模块是推荐的 PowerShell 模块,用于使用 PowerShell 管理 Azure 资源管理器 (ARM) 资源。
语法
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>]
说明
Add-AzureEndpoint cmdlet 将终结点添加到 Azure 虚拟机对象。
示例
示例 1:添加终结点
PS C:\> Get-AzureVM -ServiceName "ContosoService" -Name "VirutalMachine01" | Add-AzureEndpoint -Name "HttpIn" -Protocol "tcp" -PublicPort 80 -LocalPort 8080 | Update-AzureVM
此命令使用 Get-AzureVM cmdlet 检索名为 VirtualMachine01 的虚拟机的配置。 该命令使用管道运算符将其传递给当前 cmdlet。 此 cmdlet 添加名为 HttpIn 的终结点。 终结点具有公共端口 80 和本地端口 8080。 该命令将虚拟机对象传递给 Update-AzureVM cmdlet,该 cmdlet 可实现更改。
示例 2:添加属于负载均衡组的终结点
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
此命令检索名为 VirtualMachine07 的虚拟机的配置。 当前 cmdlet 添加名为 HttpIn 的终结点。 终结点具有公共端口 80 和本地端口 8080。 终结点属于名为 WebFarm 的共享负载均衡组。 端口 80 上的 HTTP 探测(路径为“/”)监视终结点的可用性。 该命令实现更改。
示例 3:将虚拟 IP 关联到终结点
PS C:\> Get-AzureVM -ServiceName "ContosoService" -Name "VirtualMachine25" | Add-AzureEndpoint -Name "HttpIn" -Protocol "tcp" -LocalPort 8080 -PublicPort 80 -VirtualIPName "ContosoVip11" | Update-AzureVM
此命令检索名为 VirtualMachine25 的虚拟机的配置。 当前 cmdlet 添加名为 HttpIn 的终结点。 终结点具有公共端口 80 和本地端口 8080。 此命令将虚拟 IP 关联到终结点。 该命令实现更改。
参数
-ACL
指定终结点的访问控制列表 (ACL) 配置对象。
类型: | NetworkAclObject |
Position: | Named |
默认值: | None |
必需: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DefaultProbe
指示此 cmdlet 使用默认探测设置。
类型: | SwitchParameter |
Position: | Named |
默认值: | None |
必需: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DirectServerReturn
指定此 cmdlet 是否启用直接服务器返回。 指定要启用的$True,或指定要禁用的$False。
类型: | Boolean |
Position: | Named |
默认值: | None |
必需: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-IdleTimeoutInMinutes
指定终结点的 TCP 空闲超时期限(以分钟为单位)。
类型: | Int32 |
Position: | Named |
默认值: | None |
必需: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InformationAction
指定此 cmdlet 如何响应信息事件。
此参数的可接受值为:
- 继续
- 忽略
- 询问
- SilentlyContinue
- 停止
- Suspend
类型: | ActionPreference |
Aliases: | infa |
Position: | Named |
默认值: | None |
必需: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InformationVariable
指定信息变量。
类型: | String |
Aliases: | iv |
Position: | Named |
默认值: | None |
必需: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InternalLoadBalancerName
指定内部负载均衡器的名称。
类型: | String |
Position: | Named |
默认值: | None |
必需: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-LBSetName
指定终结点的负载均衡器集的名称。
类型: | String |
Aliases: | LoadBalancedEndpointSetName |
Position: | Named |
默认值: | None |
必需: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-LoadBalancerDistribution
指定负载均衡器分发算法。 有效值为:
- sourceIP。 两个元组相关性:源 IP、目标 IP
- sourceIPProtocol。 三个元组相关性:源 IP、目标 IP、协议
- 没有。 五个元组相关性:源 IP、源端口、目标 IP、目标端口、协议
默认值为 none。
类型: | String |
Position: | Named |
默认值: | None |
必需: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-LocalPort
指定此终结点使用的本地专用端口。 虚拟机中的应用程序侦听此端口,以获取此终结点的服务输入请求。
类型: | Int32 |
Position: | 2 |
默认值: | None |
必需: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Name
指定终结点的名称。
类型: | String |
Position: | 0 |
默认值: | None |
必需: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-NoProbe
指示此 cmdlet 不使用探测设置。
类型: | SwitchParameter |
Position: | Named |
默认值: | None |
必需: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ProbeIntervalInSeconds
指定终结点的探测轮询间隔(以秒为单位)。
类型: | Int32 |
Position: | Named |
默认值: | None |
必需: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ProbePath
指定 HTTP 探测的相对路径。
类型: | String |
Position: | Named |
默认值: | None |
必需: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ProbePort
指定终结点使用的端口。
类型: | Int32 |
Position: | Named |
默认值: | None |
必需: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ProbeProtocol
指定端口协议。 有效值为:
- tcp
- http
类型: | String |
Position: | Named |
默认值: | None |
必需: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ProbeTimeoutInSeconds
指定探测轮询超时周期(以秒为单位)。
类型: | Int32 |
Position: | Named |
默认值: | None |
必需: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Profile
指定此 cmdlet 从中读取的 Azure 配置文件。 如果未指定配置文件,此 cmdlet 将从本地默认配置文件中读取。
类型: | AzureSMProfile |
Position: | Named |
默认值: | None |
必需: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Protocol
指定终结点的协议。 有效值为:
- tcp
- _udp
类型: | String |
Position: | 1 |
默认值: | None |
必需: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PublicPort
指定终结点使用的公共端口。 如果未指定值,Azure 会分配可用端口。
类型: | Int32 |
Position: | Named |
默认值: | None |
必需: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-VirtualIPName
指定 Azure 关联到终结点的虚拟 IP 地址的名称。 服务可以有多个虚拟 IP。 若要创建虚拟 IP,请使用 Add-AzureVirtualIP cmdlet。
类型: | String |
Position: | Named |
默认值: | None |
必需: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-VM
指定终结点所属的虚拟机。
类型: | IPersistentVM |
Aliases: | InputObject |
Position: | Named |
默认值: | None |
必需: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |