Public/Invoke-B2ItemUpload.ps1
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 |
function Invoke-B2ItemUpload { <# .SYNOPSIS The Invoke-B2ItemUpload cmdlet uploads files to a specified bucket. .DESCRIPTION The Invoke-B2ItemUpload cmdlet uploads files to a specified bucket. When uploading a file keep in mind that: - It must not exceed 5 billion bytes or 4.6 GB - It's name must be a UTF-8 string with a max size of 1000 bytes. An API key is required to use this cmdlet. .EXAMPLE Invoke-B2ItemUpload -BucketID 4a48fe8875c6214145260818 -Path '.\hello.txt' Name : hello.txt FileInfo : @{author=Administrators} Type : text/plain Length : 38 BucketID : 4a48fe8875c6214145260818 AccountID : 30f20426f0b1 SHA1 : E1E64A1C6E535763C5B775BAAD2ACF792D97F7DA ID : 4_z4a48fe8875c6214145260818_f1073d0771c828c7f_d20160131_m052759_c001_v0001000_t0014 The cmdlet above will upload the file hello.txt to the selected bucket ID and metadata about the uploaded file will be returned if the cmdlet is successfull. .EXAMPLE PS C:\>Invoke-B2ItemUpload -BucketID 4a48fe8875c6214145260818 -Path '.\hello.txt','.\world.txt' Name : hello.txt FileInfo : @{author=Administrators} Type : text/plain Length : 38 BucketID : 4a48fe8875c6214145260818 AccountID : 30f20426f0b1 SHA1 : E1E64A1C6E535763C5B775BAAD2ACF792D97F7DA ID : 4_z4a48fe8875c6214145260818_f1073d0771c828c7f_d20160131_m052759_c001_v0001000_t0014 Name : world.txt FileInfo : @{author=Administrators} Type : text/plain Length : 38 BucketID : 4a48fe8875c6214145260818 AccountID : 30f20426f0b1 SHA1 : E1E64A1C6E535763C5B775BAAD2ACF792D97F7DA ID : 4_z4a48fe8875c6214145260818_f1073d0771c828c7f_d20160131_m052759_c001_v0001000_t0014 The cmdlet above will upload the files hello.txt and world.txt to the selected bucket ID. .EXAMPLE PS C:\>Get-ChildItem | Invoke-B2ItemUpload -BucketID 4a48fe8875c6214145260818 Name : hello.txt FileInfo : @{author=Administrators} Type : text/plain Length : 38 BucketID : 4a48fe8875c6214145260818 AccountID : 30f20426f0b1 SHA1 : E1E64A1C6E535763C5B775BAAD2ACF792D97F7DA ID : 4_z4a48fe8875c6214145260818_f1073d0771c828c7f_d20160131_m052759_c001_v0001000_t0014 Name : world.txt FileInfo : @{author=Administrators} Type : text/plain Length : 38 BucketID : 4a48fe8875c6214145260818 AccountID : 30f20426f0b1 SHA1 : E1E64A1C6E535763C5B775BAAD2ACF792D97F7DA ID : 4_z4a48fe8875c6214145260818_f1073d0771c828c7f_d20160131_m052759_c001_v0001000_t0014 The cmdlet above will upload all files returned by the Get-ChildItem cmdlet. .INPUTS System.String This cmdlet takes the AccountID and ApplicationKey as strings. .OUTPUTS PS.B2.FileProperty This cmdlet will output a PS.B2.FileProperty object holding the file properties. .LINK https://www.backblaze.com/b2/docs/ .ROLE PS.B2 .FUNCTIONALITY PS.B2 #> [CmdletBinding(SupportsShouldProcess=$true, ConfirmImpact='Medium')] [Alias('ib2iu')] [OutputType('PS.B2.FileProperty')] Param ( # The ID of the bucket to update. [Parameter(Mandatory=$true, Position=0)] [ValidateNotNull()] [ValidateNotNullOrEmpty()] [String]$BucketID, # The file(s) to upload. [Parameter(Mandatory=$true, ValueFromPipeline=$true, ValueFromPipelineByPropertyName=$true, Position=1)] [ValidateNotNull()] [ValidateNotNullOrEmpty()] [Alias('FullName')] [String[]]$Path, # Used to bypass confirmation prompts. [Parameter(Mandatory=$false, Position=2)] [ValidateNotNull()] [ValidateNotNullOrEmpty()] [Switch]$Force ) Begin { # Pulls the unique pod upload uri for this session. $b2Upload = Get-B2UploadUri -BucketID $BucketID } Process { foreach($file in $Path) { if($Force -or $PSCmdlet.ShouldProcess($file, "Upload to bucket $BucketID.")) { try { # Required file info is retireved in this block and escapes HTTP data. [String]$b2FileName = (Get-Item -Path $file).Name $b2FileName = [System.Uri]::EscapeDataString($b2FileName) # System.Web.MimeMapping is imported from the Set-OutputTypes script. [String]$b2FileMime = [System.Web.MimeMapping]::GetMimeMapping($file) # SHA1 is used as per B2 specification. [String]$b2FileSHA1 = (Get-FileHash -Path $file -Algorithm SHA1).Hash [String]$b2FileAuthor = (Get-Acl -Path $file).Owner # Below the file author is parsed. $b2FileAuthor = $b2FileAuthor.Substring($b2FileAuthor.IndexOf('\')+1) # The file information is placed into the session headers. [Hashtable]$sessionHeaders = @{ 'Authorization' = $b2Upload.Token 'X-Bz-File-Name' = $b2FileName 'Content-Type' = $b2FileMime 'X-Bz-Content-Sha1' = $b2FileSHA1 'X-Bz-Info-Author' = $b2FileAuthor } $bbInfo = Invoke-RestMethod -Method Post -Uri $b2Upload.UploadUri -Headers $sessionHeaders -InFile $file $bbReturnInfo = [PSCustomObject]@{ 'Name' = $bbInfo.fileName 'FileInfo' = $bbInfo.fileInfo 'Type' = $bbInfo.contentType 'Length' = $bbInfo.contentLength 'BucketID' = $bbInfo.bucketId 'AccountID' = $bbInfo.accountId 'SHA1' = $bbInfo.contentSha1 'ID' = $bbInfo.fileId } # bbReturnInfo is returned after Add-ObjectDetail is processed. Add-ObjectDetail -InputObject $bbReturnInfo -TypeName 'PS.B2.FileProperty' } catch { $errorDetail = $_.Exception.Message Write-Error -Exception "Unable to upload the file.`n`r$errorDetail" ` -Message "Unable to upload the file.`n`r$errorDetail" -Category InvalidOperation } } } } } |