diff --git a/pages/windows/choco-upgrade.md b/pages/windows/choco-upgrade.md
new file mode 100644
index 0000000000..c4eb74ca7a
--- /dev/null
+++ b/pages/windows/choco-upgrade.md
@@ -0,0 +1,31 @@
+# choco upgrade
+
+> Upgrade one or more packages with Chocolatey.
+
+- Upgrade one or more space-separated packages:
+
+`choco upgrade {{package(s)}}`
+
+- Upgrade to a specific version of a package:
+
+`choco upgrade {{package}} --version {{version}}`
+
+- Upgrade all packages:
+
+`choco upgrade all`
+
+- Upgrade all except specified comma-separated packages:
+
+`choco upgrade all --except "{{package(s)}}"`
+
+- Confirm all prompts automatically:
+
+`choco upgrade {{package}} --yes`
+
+- Specify a custom source to receive packages from:
+
+`choco upgrade {{package}} --source {{source_url|alias}}`
+
+- Provide a username and password for authentication:
+
+`choco upgrade {{package}} --user {{username}} --password {{password}}`