Add ReturnValue parameter to Invoke-TwitterCursorRequest

[thedavecarroll]

Add a ReturnValue parameter to Invoke-TwitterCursorRequest.

This will allow for tidier code in the public functions.

Instead of wrapping the returned values in an array and returning the required property like this:

$TwitterFollowers = Invoke-TwitterCursorRequest -OAuthParameters $OAuthParameters
@($TwitterFollowers.ids)

or this:

@(Invoke-TwitterCursorRequest -OAuthParameters $OAuthParameters).ids

You can simple provide the property as the ReturnValue, like this:

Invoke-TwitterCursorRequest -OAuthParameters $OAuthParameters -ReturnValue ids

This is a typical return for ids and users from a cursored request.

ids                 : {…}
next_cursor         : 0
next_cursor_str     : 0
previous_cursor     : 0
previous_cursor_str : 0
total_count         :

users               : {@{}...}
next_cursor         : 0
next_cursor_str     : 0
previous_cursor     : 0
previous_cursor_str : 0
total_count         :