Func_Get-OneDriveChildItem.ps1

################################################################################
# Author     : Antony Onipko
# Copyright  : (c) 2016 Antony Onipko. All rights reserved.
################################################################################
# This work is licensed under the
# Creative Commons Attribution-ShareAlike 4.0 International License.
# To view a copy of this license, visit
# https://creativecommons.org/licenses/by-sa/4.0/
################################################################################

Function Get-OneDriveChildItem {
    <#
        .SYNOPSIS
        Gets the items in the specified path, or that are children of the specified Item ID from the OneDrive API. By default gets the items in the default drive's root. Can be used with either a relative path, or an item id.
        
        .EXAMPLE
        Get-OneDriveChildItem # Gets all the items in the default drive's root.

        .EXAMPLE
        "Documents" | Get-OneDriveChildItem

        .EXAMPLE
        Get-OneDriveChildItem -ItemId "1234ABC!123"
    #>
    [CmdletBinding(DefaultParameterSetName='Item Path')]
    [Alias('odgci','odls')]
    [OutputType([PsObject])]
    Param
    (
        # API resource path.
        [Parameter(Mandatory=$False,
                   Position=1,
                   ValueFromPipeline=$True,
                   ValueFromPipelineByPropertyName=$True,
                   ParameterSetName='Item Path')]
        [Alias('ApiUrl', 'Resource')]
        [string]$Path,

        # API item ID.
        [Parameter(Mandatory=$True,
                   Position=1,
                   ValueFromPipelineByPropertyName=$True,
                   ParameterSetName='Item ID')]
        [Alias('id')]
        [string]$ItemId,

        # Gets the items in the specified path, and all child items.
        [Parameter(Mandatory=$False)]
        [switch]$Recurse
    )

    Process {

        if ($ItemId) {
            $rsp = Get-OneDriveItem -ItemId (joinPath $ItemId 'children')
        } else {
            $rsp = Get-OneDriveItem -Path (joinPath $Path 'children' ':/')
        }

        Write-Output $rsp

        if ($Recurse) {
            $rsp | ? { [int]$_.folder.childCount -gt 0 } | % {
                Get-OneDriveChildItem -ItemId $_.id -Recurse
            }
        }
        
    }

}

Export-ModuleMember -Function 'Get-OneDriveChildItem' -Alias 'odgci', 'odls'