Get-Objects

Summary

Retrieves a collection of object objects.

Get-Objects
    -Top
    -Skip
    -Filter
    -OrderBy

Returns a collection object with the following properties:

Property	Type	Notes
Collection	Collection of object objects	The collection of entries retrieved after top, skip, filter, and order by parameters were applied.
Top	Int32	The top parameter value that was used. Useful while paging data.
Skip	Int32	The skip parameter value that was used. Useful while paging data.
TotalCount	Int32	The total count of records available after any filtering was applied. Useful while paging data.

Parameters

Parameter	Type	Required?	Notes
Top	Int32	No, Defaults to 40	Total number of entries to retrieve. Max is 1000.
Skip	Int32	No, Defaults to 0	How many entries should be skipped within the collection. Used for paging the results.
Filter	String	No	An OData 4 string that can be used for filtering the collection.
OrderBy	String	No	An OData 4 string that can be used for sorting the collection by specific fields.

Examples

Get a collection of OBJECTS

# Retrieve one record from the collection, since we're only interested in the total count.
$collectionWrapper = Get-Objects -Top 1

Write-Output "There are $($collectionWrapper.TotalCount) object(s) in the workspace"

There are 14 object(s) in the workspace