Contents x
    Get-Contacts
    • 1 Minute to read
    • Print
    • Dark
      Light
    • PDF
    Contents

    Get-Contacts

    • 1 Minute to read
    • Print
    • Dark
      Light
    • PDF
    Article summary

    Summary

    Retrieves a collection of contact field cache objects.

    Get-Contacts
    -Top
    -Skip
    -Filter
    -OrderBy

    Returns a collection object with the following properties:

    PropertyTypeNotes
    CollectionCollection of contact field cache objectsThe collection of entries retrieved after top, skip, filter, and order by parameters were applied.
    TopInt32The top parameter value that was used. Useful while paging data.
    SkipInt32The skip parameter value that was used. Useful while paging data.
    TotalCountInt32The total count of records available after any filtering was applied. Useful while paging data.
    Field Cache Objects
    Field cache objects cannot be used directly for updating an object using the Set-* command. Instead, you will need to retrieve the object you intend to update directly, modify the properties you want to update, and then save that object using the Set-* command.

    Parameters

    ParameterTypeRequired?Notes
    TopInt32No, Defaults to 40Total number of entries to retrieve. Max is 1000.
    SkipInt32No, Defaults to 0How many entries should be skipped within the collection. Used for paging the results.
    FilterStringNoAn OData 4 string that can be used for filtering the collection.
    OrderByStringNoAn OData 4 string that can be used for sorting the collection by specific fields.

    Examples

    Get a collection of contacts

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

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

    Results of executing the script:

    There are 786 contact(s) in the workspace
    What's Next