Func_Invoke-OneDriveApiCall.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 Invoke-OneDriveApiCall { <# .SYNOPSIS Wrapper for Invoke-RestMethod to send commands to the OneDrive API. .EXAMPLE Invoke-OneDriveApiCall -Path $path .EXAMPLE 'drive/root:/Documents:/children' | Invoke-OneDriveApiCall #> [CmdletBinding()] [OutputType([PsObject])] Param ( # API resource path. [Parameter(Mandatory=$True, Position=1, ValueFromPipeline=$True, ValueFromPipelineByPropertyName=$True)] [Alias("ApiUrl", "Resource")] [string]$Path, # The method used for the API request. [Parameter(Mandatory=$False, ValueFromPipelineByPropertyName=$True)] [Microsoft.PowerShell.Commands.WebRequestMethod]$Method, # Data to be sent as part of the API request. [Parameter(Mandatory=$False, ValueFromPipelineByPropertyName=$True)] $Body, # Gets the content of the request from the specified file. [Parameter(Mandatory=$False, ValueFromPipelineByPropertyName=$True)] [string]$InFile, # Saves the response to the specified path. [Parameter(Mandatory=$False, ValueFromPipelineByPropertyName=$True)] [string]$OutFile, # Additional headers for the request. [Parameter(Mandatory=$False, ValueFromPipelineByPropertyName=$True)] [hashtable]$AdditionalRequestHeaders ) Begin { if ((Get-Date) -ge $PSOD.token.ExpiryDate) { Write-Verbose "Requesting new token." $token = Get-OneDriveAuthToken if ($token) { $PSOD.token = $token } else { Write-Error "Unable to authenticate with OneDrive. Please check the configuration file." break } } } Process { $requestUri = joinPath $PSOD.api.url $Path Write-Verbose "Request URI:`n$requestUri" $requestHeaders = @{ Authorization = "bearer $($PSOD.token)" Accept = 'application/json' } if ($AdditionalRequestHeaders) { $requestHeaders += $AdditionalRequestHeaders } $irmParams = @{ Uri = $requestUri Headers = $requestHeaders ContentType = 'application/json' } if ($Method) { $irmParams['Method'] = $Method } if ($Body) { $irmParams['Body'] = $Body } if ($InFile) { $irmParams['InFile'] = $InFile } if ($OutFile) { $irmParams['OutFile'] = $OutFile } try { $rsp = Invoke-RestMethod @irmParams } catch [System.Net.WebException] { $errorMessage = $_.ErrorDetails.Message | ConvertFrom-Json Write-Error "'$Path' - $($errorMessage.error.message). (Error code: $($errorMessage.error.code))" $httpResponse = $_.Exception.Response Write-Verbose "HTTP status code : $($httpResponse.StatusCode.value__)" Write-Verbose "HTTP status description : $($httpResponse.StatusDescription)" } catch { Write-Error $_.Exception.Message } Write-Output $rsp } } Export-ModuleMember -Function 'Invoke-OneDriveApiCall' |