Specifies the maximum number of characters permitted in the $filter query parameter of a OData request.

Syntax

Connect-OData -MaxFilterLength int

Data Type

int

Default Value

-1

Remarks

Certain APIs impose restrictions on the number of characters that can be included in a URL. When the filter becomes too long, some services can return an error or become unresponsive. The purpose of this property is to process filters client-side if the filter parameter exceeds this value, thus avoiding errors or hangs.

If MaxFilterLength is set to a positive number, the driver will ensure we do not send a filter to the service that exceeds the character length set in MaxFilterLength. If exceeded, the filter will be processed entirely on the client side. This should only be changed if the services limit the character length; otherwise, it should remain unlimited by default.