Rename folder Docs to docs

docs/upload-to-dropbox.md

@@ -0,0 +1,77 @@
+*upload-to-dropbox.ps1*
+================
+
+This PowerShell script uploads a local file to Dropbox.
+
+Parameters
+----------
+```powershell
+PS> ./upload-to-dropbox.ps1 [-SourceFilePath] <String> [<CommonParameters>]
+
+-SourceFilePath <String>
+    
+    Required?                    true
+    Position?                    1
+    Default value                
+    Accept pipeline input?       true (ByValue)
+    Accept wildcard characters?  false
+
+[<CommonParameters>]
+    This script supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, 
+    WarningVariable, OutBuffer, PipelineVariable, and OutVariable.
+```
+
+Example
+-------
+```powershell
+PS> .\upload-to-dropbox.ps1 my.txt
+
+```
+
+Notes
+-----
+Author: Markus Fleschutz | License: CC0
+
+Related Links
+-------------
+https://github.com/fleschutz/PowerShell
+
+Script Content
+--------------
+```powershell
+<#
+.SYNOPSIS
+	Uploads a file to Dropbox
+.DESCRIPTION
+	This PowerShell script uploads a local file to Dropbox.
+.PARAMETER Path
+	Specifies the path to the local file
+.EXAMPLE
+	PS> .\upload-to-dropbox.ps1 my.txt
+.LINK
+	https://github.com/fleschutz/PowerShell
+.NOTES
+	Author: Markus Fleschutz | License: CC0
+#>
+
+param([Parameter (Mandatory = $True, ValueFromPipeline = $True)] [Alias("f")] [string]$SourceFilePath) 
+
+try {
+	$DropBoxAccessToken = "YOUR-DROPBOX-ACCESS-TOKEN-HERE"   # Replace with your DropBox Access Token
+	$outputFile = Split-Path $SourceFilePath -leaf
+	$TargetFilePath="/$outputFile"
+	$arg = '{ "path": "' + $TargetFilePath + '", "mode": "add", "autorename": true, "mute": false }'
+	$authorization = "Bearer " + $DropBoxAccessToken
+	$headers = New-Object "System.Collections.Generic.Dictionary[[String],[String]]"
+	$headers.Add("Authorization", $authorization)
+	$headers.Add("Dropbox-API-Arg", $arg)
+	$headers.Add("Content-Type", 'application/octet-stream')
+	Invoke-RestMethod -Uri https://content.dropboxapi.com/2/files/upload -Method Post -InFile $SourceFilePath -Headers $headers
+	exit 0 # success
+} catch {
+	"⚠️ Error in line $($_.InvocationInfo.ScriptLineNumber): $($Error[0]) after $Elapsed sec."
+	exit 1
+}
+```
+
+*(generated by convert-ps2md.ps1 using the comment-based help of upload-to-dropbox.ps1 as of 10/19/2023 08:11:43)*