Func_Copy-OneDriveItem.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 Copy-OneDriveItem { <# .SYNOPSIS Copies a one drive item from one path to another. .EXAMPLE "Documents/file.pdf" | Copy-OneDriveItem "destination/directory" .EXAMPLE Copy-OneDriveItem -ItemID "85B75A4CE0397EE!1492" -destination "destination/directory" .EXAMPLE Copy-OneDriveItem "Documents/DirToCopy" "destination/directory" #> [CmdletBinding(DefaultParameterSetName='Item Path')] [Alias('odcp', 'odcopy')] [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, # The path to the destination directory / file. [Parameter(Mandatory=$True, Position=2)] [string]$Destination ) Process { if ($ItemId) { $p = joinPath $PSOD.drive.itemRoot $ItemId $p = joinPath $p 'action.copy' } else { $p = joinPath $PSOD.drive.pathRoot $Path $p = joinPath $p 'action.copy' ':/' } Write-Verbose "Sending request to '$p'" $body = [ordered]@{ parentReference = @{ path = "/" + (joinPath $PSOD.drive.pathRoot $Destination) } } | ConvertTo-Json Write-Verbose "Request body:`n$body" $rsp = Invoke-OneDriveApiCall -Path $p ` -Method POST ` -Body $body ` -AdditionalRequestHeaders @{ Prefer = "respond-async" } # TODO: Implement a way to check when a copy is finished. if ($rsp) { Write-Output $rsp } } } Export-ModuleMember -Function 'Copy-OneDriveItem' -Alias 'odcp', 'odcopy' |