使用 Windows Server AppFabric Cmdlet 配置终结点
本主题介绍了如何使用 AppFabric cmdlet 来配置服务的终结点。
备注
要手动执行 AppFabric cmdlet，请打开 AppFabric 的 Windows PowerShell 控制台，输入相应的 cmdlet，然后按 Enter。有关执行 cmdlet 的详细信息，请参阅运行 Windows Server AppFabric Cmdlet。有关本文档的语法说明中使用的任何类或通用参数的信息，请参阅Windows PowerShell for Windows Server AppFabric 参考。
设置服务的终结点
在 AppFabric 的 Windows PowerShell 控制台中，请执行 Set-ASAppServiceEndpoint cmdlet 来修改终结点。该 cmdlet 会返回代表更新的终结点配置的 ServiceEndpointInfo。此操作只允许更改本地（特定作用域）配置的服务上终结点的地址。
Set-ASAppServiceEndpoint cmdlet 的语法选项：
语法 1
Set-ASAppServiceEndpoint -SiteName <string> -VirtualPath <string> –Address <string> -BindingName <string> -ContractName <string> -NewAddress <string>
语法 2
Set-ASAppServiceEndpoint -Uri <string> –Address <string> -BindingName <string> -ContractName <string> -NewAddress <string>
语法 3
Set-ASAppServiceEndpoint -ServiceObject <ServiceInfo> –Address <string> -BindingName <string> -ContractName <string> -NewAddress <string>
| 参数 | 描述 |
|---|---|
-SiteName（可选） |
指定包含要尝试配置终结点服务的站点名称。如果指定该参数，则不得指定 -Uri 或 –ServiceObject。 |
-VirtualPath（可选） |
指定包含要尝试配置终结点服务的服务或应用程序虚拟路径，例如，/MyDir1/MyApp1/POService.svc。这是一个可选参数，在未指定 –Uri 和 –ServiceObject 时与 -SiteName 一起使用。 |
-Uri（可选） |
指定要尝试配置终结点的站点、应用程序或服务的 URI。如果指定该参数，则不得指定 –SiteName、-VirtualPath 或 –ServiceObject。 |
-ServiceObject（可选） |
指定用于确定要尝试配置终结点服务的 ServiceInfo 对象。如果指定该参数，则不得指定 –SiteName、-VirtualPath 或 –Uri。此参数主要用于管道传输方案。有关详细信息，请参阅Windows PowerShell for Windows Server AppFabric 参考。 |
–Address <string> |
要修改的当前终结点地址。 |
-BindingName <string> |
要更改的终结点绑定。 |
-ContractName <string> |
要更改的终结点协定。 |
-NewAddress <string> |
终结点的新地址。 |
设置终结点传输配额
在 AppFabric 的 Windows PowerShell 控制台中，请执行 Set-ASAppServiceEndpointTransportQuota cmdlet 来为终结点配置传输配额。如果终结点已具有绑定配置且其为本地配置，则使用指定的传输配额属性对其进行更新。
Set-ASAppServiceEndpointTransportQuota cmdlet 的语法选项：
语法 1
Set-ASAppServiceEndpointTransportQuota -Address<string> -Binding<string> -Contract<string> [–ListenBacklog][–MaxBufferPoolSize][–MaxBufferSize][–MaxConnections][–MaxReceivedMessageSize]
语法 2
Set-ASAppServiceEndpointTransportQuota –ServiceEndpointObject <ServiceEndpointInfo> [–ListenBacklog][–MaxBufferPoolSize][–MaxBufferSize][–MaxConnections][–MaxReceivedMessageSize]
语法 3
Set-ASAppServiceEndpointTransportQuota -Address<string> -Binding<string> -Contract<string> -Use Defaults
语法 4
Set-ASAppServiceEndpointTransportQuota –ServiceEndpointObject <ServiceEndpointInfo> -Use Defaults
| 参数 | 描述 |
|---|---|
-Address<string> -Binding<string> -Contract<string>（未使用 ServiceEndpointObject 时为必需） |
指定终结点的地址、绑定和协定。 |
-ServiceEndpointObject <ServiceEndpointInfo>（未使用 Address、Binding 和 Contract 时为必需） |
|
-Use Defaults |
使用 -ListenBacklog、-MaxBufferPoolSize、–MaxBufferSize、–MaxConnections 和 -MaxReceivedMessageSize 的默认参数值。 |
-ListenBacklog、-MaxBufferPoolSize、–MaxBufferSize、–MaxConnections 和 -MaxReceivedMessageSize |
有关传输配额配置、默认值、用于特定绑定的参数，以及各参数定义的详细信息，请参阅传输配额 (https://go.microsoft.com/fwlink/?LinkId=160232)。 |
有关此 cmdlet 的详细信息，请参阅 Set-ASAppServiceEndpointTransportQuota。
2011-12-05