Add-AzureEndpoint

參考

模組:: Azure

將端點新增至虛擬機。

注意

本文件中參考的 Cmdlet 用於管理使用 Azure Service Manager（ASM） API 的舊版 Azure 資源。建立新的資源時，不建議使用此舊版 PowerShell 模組，因為 ASM 已排定淘汰。如需詳細資訊，請參閱 Azure Service Manager 淘汰。

Az PowerShell 模組是使用 PowerShell 管理 Azure Resource Manager （ARM）資源的建議 PowerShell 模組。

語法

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

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，以實作您的變更。

範例 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
接受管線輸入:	False
接受萬用字元:	False

-DefaultProbe

表示此 Cmdlet 使用預設探查設定。

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-DirectServerReturn

指定此 Cmdlet 是否啟用直接伺服器傳回。指定要啟用的$True，或指定要停用的$False。

類型:	Boolean
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-IdleTimeoutInMinutes

指定端點的 TCP 閑置逾時期間，以分鐘為單位。

類型:	Int32
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-InformationAction

指定此 Cmdlet 如何回應資訊事件。

此參數可接受的值為：

繼續
忽略
詢問
SilentlyContinue
停止
暫止

類型:	ActionPreference
別名:	infa
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-InformationVariable

指定資訊變數。

類型:	String
別名:	iv
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-InternalLoadBalancerName

指定內部負載平衡器的名稱。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-LBSetName

指定端點的負載平衡器集名稱。

類型:	String
別名:	LoadBalancedEndpointSetName
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-LoadBalancerDistribution

指定負載平衡器分配演算法。有效值為：

sourceIP。兩個 Tuple 親和性：來源 IP、目的地 IP
sourceIPProtocol。三個 Tuple 親和性：來源 IP、目的地 IP、通訊協定
沒有。五個 Tuple 親和性：來源 IP、來源埠、目的地 IP、目的地埠、通訊協定

預設值為 none。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-LocalPort

指定此端點使用的本機、私人埠。虛擬機內的應用程式會接聽此埠上的應用程式，以取得此端點的服務輸入要求。

類型:	Int32
Position:	2
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-Name

指定端點的名稱。

類型:	String
Position:	0
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-NoProbe

表示此 Cmdlet 不會使用探查設定。

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-ProbeIntervalInSeconds

指定端點的探查輪詢間隔，以秒為單位。

類型:	Int32
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-ProbePath

指定 HTTP 探查的相對路徑。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-ProbePort

指定端點使用的埠。

類型:	Int32
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-ProbeProtocol

指定埠通訊協定。有效值為：

tcp
HTTP

類型:	String
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-ProbeTimeoutInSeconds

指定探查輪詢逾時期間，以秒為單位。

類型:	Int32
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Profile

指定此 Cmdlet 從中讀取的 Azure 設定檔。如果您未指定設定檔，此 Cmdlet 會從本機預設配置檔讀取。

類型:	AzureSMProfile
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Protocol

指定端點的通訊協定。有效值為：

類型:	String
Position:	1
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-PublicPort

指定端點使用的公用埠。如果您未指定值，Azure 會指派可用的埠。

類型:	Int32
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-VirtualIPName

指定 Azure 與端點相關聯的虛擬 IP 位址名稱。您的服務可以有多個虛擬IP。若要建立虛擬IP，請使用 Add-AzureVirtualIP Cmdlet。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-VM

指定端點所屬的虛擬機。

類型:	IPersistentVM
別名:	InputObject
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	True
接受萬用字元:	False

輸出

Object

共用方式為

Add-AzureEndpoint

語法

Description

範例

範例 1：新增端點

範例 2：新增屬於負載平衡群組的端點

範例 3：將虛擬 IP 與端點產生關聯

參數

-ACL

-DefaultProbe

-DirectServerReturn

-IdleTimeoutInMinutes

-InformationAction

-InformationVariable

-InternalLoadBalancerName

-LBSetName

-LoadBalancerDistribution

-LocalPort

-Name

-NoProbe

-ProbeIntervalInSeconds

-ProbePath

-ProbePort

-ProbeProtocol

-ProbeTimeoutInSeconds

-Profile

-Protocol

-PublicPort

-VirtualIPName

-VM

輸出

其他資源

共用方式為

Add-AzureEndpoint

語法

Description

範例

範例 1：新增端點

範例 2：新增屬於負載平衡群組的端點

範例 3：將虛擬 IP 與端點產生關聯

參數

-ACL

-DefaultProbe

-DirectServerReturn

-IdleTimeoutInMinutes

-InformationAction

-InformationVariable

-InternalLoadBalancerName

-LBSetName

-LoadBalancerDistribution

-LocalPort

-Name

-NoProbe

-ProbeIntervalInSeconds

-ProbePath

-ProbePort

-ProbeProtocol

-ProbeTimeoutInSeconds

-Profile

-Protocol

-PublicPort

-VirtualIPName

-VM

輸出

相關連結

其他資源