Export (0) Print
Expand All
Expand Minimize

Set-ASAppServiceEndpointTransportQuota

Set-ASAppServiceEndpointTransportQuota

Sets the transport quotas (maximum buffer pool size, maximum received message size etc…) supported by an endpoint.

Syntax

Parameter Set: SiteNameAndVirtualPath
Set-ASAppServiceEndpointTransportQuota [-SiteName] <String> [-VirtualPath] <String> [[-Address] <String> ] [-Binding] <String> [-Contract] <String> [-ListenBacklog <Int32> ] [-MaxBufferPoolSize <Int64> ] [-MaxBufferSize <Int32> ] [-MaxConnections <Int32> ] [-MaxReceivedMessageSize <Int64> ] [-TransportQuotaObject <ServiceEndpointTransportQuotaInfo> ] [-UseDefaults] [-Confirm] [-WhatIf] [ <CommonParameters>]


Parameters

-Address<String>

Address of the endpoint.


Aliases

none

Required?

false

Position?

3

Default Value

none

Accept Pipeline Input?

true (ByPropertyName)

Accept Wildcard Characters?

-Binding<String>

Binding of the endpoint.


Aliases

none

Required?

true

Position?

4

Default Value

none

Accept Pipeline Input?

true (ByPropertyName)

Accept Wildcard Characters?

-Contract<String>

Contract supported by the endpoint.


Aliases

none

Required?

true

Position?

5

Default Value

none

Accept Pipeline Input?

true (ByPropertyName)

Accept Wildcard Characters?

-ListenBacklog<Int32>

Specifies the maximum number of queued connection requests that can be pending. The ListenBacklog is a socket-level property that describes the number of "pending accept" requests to be queued. Ensure that the underlying socket queue is not exceeded by the maximum number of concurrent connections. This property is displayed only if the NetTcpBinding binding is configured for this endpoint.


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

-MaxBufferPoolSize<Int64>

Specifies the maximum buffer pool size for this binding. The default is 512 * 1024 bytes. Many parts of Windows Communication Foundation (WCF) use buffers. Creating and destroying buffers each time they are used is expensive, and garbage collection for buffers is also expensive. With buffer pools, you can take a buffer from the pool, use it, and return it to the pool once you are done. Thus the overhead in creating and destroying buffers is avoided. This property is displayed for all of the AppFabric supported bindings


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

-MaxBufferSize<Int32>

Specifies the maximum size, in bytes, of the buffer used to store messages in memory. If thetransferModeattribute equals toBuffered, this attribute should be equal to themaxReceivedMessageSizeattribute value. If thetransferModeattribute equals toStreamed, this attribute cannot be more than themaxReceivedMessageSizeattribute value, and should be at least the size of the headers. This property is displayed only if theBasicHttpBinding,NetTcpBinding, orNetNamedPipebindingbindings are configured for this endpoint.


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

-MaxConnections<Int32>

Specifies the maximum number of outbound and inbound connections the service will create/accept. Incoming and outgoing connections are counted against a separate limit specified by this attribute. Inbound connections in excess of the limit are queued until a space below the limit becomes available. Outbound connections in excess of the limit are queued until a space below the limit becomes available. This property is displayed only if theNetTcpBindingorNetNamedPipeBindingbindings are configured for this endpoint. The default is 10.


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

-MaxReceivedMessageSize<Int64>

A positive integer that specifies the maximum message size, in bytes, including headers, that can be received on a channel configured with this binding. The sender of a message exceeding this limit will receive a SOAP fault. The receiver drops the message and creates an entry of the event in the trace log. This property is displayed for all of the AppFabric supported bindings. The default is 65536.


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

-ServiceObject<ServiceInfo>

The name of the ServiceObject, which specifies that the cmdlet will operate on that service. This parameter is typically used to pipe the output of the Get-ASAppService cmdlet to a cmdlet containing the ServiceObject parameter.


Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

true (ByValue)

Accept Wildcard Characters?

-SiteName<String>

The name of a Web site, as defined in the IIS Connections pane, which specifies that the cmdlet will operate at the scope of a service contained within that site. To the SiteName parameter, you must add the VirtualPath parameter that identifies a service contained within the site.

The virtual path must include the name of the application, a forward slash, and the name of the .svc file or .xamlx file for the service. The leading "/" character in the virtual path is optional. If you use the SiteName parameter, do not use the Uri parameter.


Aliases

none

Required?

true

Position?

1

Default Value

none

Accept Pipeline Input?

true (ByPropertyName)

Accept Wildcard Characters?

-TransportQuotaObject<ServiceEndpointTransportQuotaInfo>

An object that contains the transport quota information. This parameter is used mainly in piping scenarios.


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

true (ByValue)

Accept Wildcard Characters?

-Uri<Uri>

A URI for a service, which specifies that the cmdlet will operate at that scope. If you use the Uri parameter, do not use the SiteName and VirtualPath parameter set.


Aliases

none

Required?

true

Position?

1

Default Value

none

Accept Pipeline Input?

true (ByPropertyName)

Accept Wildcard Characters?

-UseDefaults

Specifies the default values for the transport quotas should be used.


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

-VirtualPath<String>

The virtual path for a service, as defined in the IIS Manager Connections pane, which specifies that the cmdlet will operate at the scope of the service. You must add the VirtualPath parameter to the SiteName parameter, using SiteName to identify the site that the service is included in. The leading "/" character in the virtual path is optional.

For a service, the virtual path includes the name of the application, a forward slash, and the name of the .svc file or .xamlx file for the service. If you use the SiteName and VirtualName parameter set, do not use the Uri parameter..


Aliases

none

Required?

true

Position?

2

Default Value

none

Accept Pipeline Input?

true (ByPropertyName)

Accept Wildcard Characters?

-Confirm

Prompts you for confirmation before executing the command.


Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-WhatIf

Describes what would happen if you executed the command without actually executing the command.


Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

<CommonParameters>

This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see about_CommonParameters

Inputs

The input type is the type of the objects that you can pipe to the cmdlet.

  • None.


Outputs

The output type is the type of the objects that the cmdlet emits.

  • None.


Examples

Example 1

Sets MaxReceivedMessageSize setting of the endpoint of the service Service1 to 50000.


Set-ASAppServiceEndpointTransportQuota -uri http://localhost/sampleapp/service1.svc -binding basicHttpBinding -contract IService1 -MaxReceivedMessageSize 50000
Show:
© 2014 Microsoft