Skip to content

Update BREAKINGCHANGES.md to Include Web Cmdlets Breaking Changes #5852

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
iSazonov merged 3 commits into from
Jan 13, 2018
Merged

Update BREAKINGCHANGES.md to Include Web Cmdlets Breaking Changes #5852

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
5ee30c7
Update BREAKINGCHANGES.md to Include Web Cmdlets Breaking Changes
markekraus Jan 10, 2018
d915bee
Update .spelling
markekraus Jan 11, 2018
5095d60
Address PR Feedback
markekraus Jan 12, 2018
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions .spelling
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -491,6 +491,7 @@ nanoserver-insider-powershell
- docs/BREAKINGCHANGES.md
7-bit
CoreFX
honored
non-Windows
psd1
runbooks
Expand Down
17 changes: 17 additions & 0 deletions docs/BREAKINGCHANGES.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -294,3 +294,20 @@ With this change, W3C extended log format is supported.

Remove the `BuildVersion` property from `$PSVersionTable`. This property was tied to the Windows build version.
Instead, we recommend that you use `GitCommitId` to retrieve the exact build version of PowerShell Core.

### Changes to Web Cmdlets

The underlying .NET API of the Web Cmdlets has been changed to `System.Net.Http.HttpClient`.
This change provides many benefits.
However, this change along with a lack of interoperability with Internet Explorer have resulted in several breaking changes within `Invoke-WebRequest` and `Invoke-RestMethod`.

* `Invoke-WebRequest` now supports basic HTML Parsing only. `Invoke-WebRequest` always returns a `BasicHtmlWebResponseObject` object.
The `ParsedHtml` and `Forms` properties have been removed.
* `BasicHtmlWebResponseObject.Headers` values are now `String[]` instead of `String`.
* `BasicHtmlWebResponseObject.BaseResponse` is now a `System.Net.Http.HttpResponseMessage` object.
* The `Response` property on Web Cmdlet exceptions is now a `System.Net.Http.HttpResponseMessage` object.
* Strict RFC header parsing is now default for the `-Headers` and `-UserAgent` parameter. This can be bypassed with `-SkipHeaderValidation`.
* `file://` and `ftp://` URI schemes are no longer supported.
* `System.Net.ServicePointManager` settings are no longer honored.
* There is currently no certificate based authentication available on macOS.
* Use of `-Credential` over an `http://` URI will result in an error. Use an `https://` URI or supply the `-AllowUnencryptedAuthentication` parameter to suppress the error.