invoke-webrequest: add page

pages/windows/curl.md

@@ -0,0 +1,15 @@
+# curl
+
+> In PowerShell, this command may be an alias of `Invoke-WebRequest` when the original `curl` program (<https://curl.se>) is not properly installed.
+
+- Check whether `curl` is properly installed by printing its version number. If this command evaluates into an error, PowerShell may have substituted this command with `Invoke-WebRequest`:
+
+`curl --version`
+
+- View documentation for the original `curl` command:
+
+`tldr curl -p common`
+
+- View documentation for PowerShell's `Invoke-WebRequest` command:
+
+`tldr invoke-webrequest`

pages/windows/invoke-webrequest.md

@@ -0,0 +1,25 @@
+# Invoke-WebRequest
+
+> Performs a HTTP/HTTPS request to the Web.
+> This command can only be used through PowerShell.
+> More information: <https://docs.microsoft.com/powershell/module/microsoft.powershell.utility/invoke-webrequest>.
+
+- Download the contents of a URL to a file:
+
+`Invoke-WebRequest {{http://example.com}} -OutFile {{filename}}`
+
+- Send form-encoded data (POST request of type `application/x-www-form-urlencoded`):
+
+`Invoke-WebRequest -Method Post -Body @{ name='bob' } {{http://example.com/form}}`
+
+- Send a request with an extra header, using a custom HTTP method:
+
+`Invoke-WebRequest -Headers {{@{ X-My-Header = '123' }}} -Method {{PUT}} {{http://example.com}}`
+
+- Send data in JSON format, specifying the appropriate content-type header:
+
+`Invoke-WebRequest -Body {{'{"name":"bob"}'}}  -ContentType 'application/json' {{http://example.com/users/1234}}`
+
+- Pass a username and password for server authentication:
+
+`Invoke-WebRequest -Headers @{ Authorization = "Basic "+ [System.Convert]::ToBase64String([System.Text.Encoding]::ASCII.GetBytes("myusername:mypassword")) } {{http://example.com}}`

pages/windows/iwr.md

@@ -0,0 +1,7 @@
+# iwr
+
+> This command is an alias of `Invoke-WebRequest` in PowerShell.
+
+- View documentation for the original command:
+
+`tldr invoke-webrequest`

pages/windows/wget.md

@@ -0,0 +1,15 @@
+# wget
+
+> In PowerShell, this command may be an alias of `Invoke-WebRequest` when the original `wget` program (<https://www.gnu.org/software/wget>) is not properly installed.
+
+- Check whether `wget` is properly installed by printing its version number. If this command evaluates into an error, PowerShell may have substituted this command with `Invoke-WebRequest`:
+
+`curl --version`
+
+- View documentation for the original `wget` command:
+
+`tldr wget -p common`
+
+- View documentation for PowerShell's `Invoke-WebRequest` command:
+
+`tldr invoke-webrequest`