Update docs about .NET Core version 2.0 to be about version 2.x (#7467)

This commit is contained in:
Christoph Bergmeister [MVP] 2018-08-31 00:51:52 +01:00 committed by Dongbo Wang
parent 944d716e82
commit b3c961f882
6 changed files with 17 additions and 14 deletions

View file

@ -6,6 +6,8 @@
#region Global Dictionary
2ae5d07
2.x
2.x.
acl
ActiveDirectory
aditya

View file

@ -5,7 +5,7 @@
Existing Windows PowerShell users are familiar with the large number of modules available, however, they are not necessarily compatible with PowerShell Core.
More information regarding compatibility is in a [blog post](https://blogs.msdn.microsoft.com/powershell/2017/07/14/powershell-6-0-roadmap-coreclr-backwards-compatibility-and-more/).
Windows PowerShell 5.1 is based on .Net Framework 4.6.1, while PowerShell Core is based on .Net Core 2.0.
Windows PowerShell 5.1 is based on .Net Framework 4.6.1, while PowerShell Core is based on .Net Core 2.x.
Although both adhere to .Net Standard 2.0 and can be compatible, some modules may be using APIs or cmdlets not supported on CoreCLR or using APIs from Windows PowerShell that have been deprecated and removed from PowerShell Core (for example, PSSnapins).
## Importing a Windows PowerShell module

View file

@ -3,7 +3,7 @@
This guide supplements the [Linux instructions](./linux.md), as
building on macOS is almost identical.
.NET Core 2.0 (and by transitivity, us) only supports macOS 10.12+.
.NET Core 2.x (and by transitivity, us) only supports macOS 10.12+.
## Environment
@ -16,7 +16,7 @@ The `Start-PSBootstrap` function does the following:
- Uses `brew` to install CMake, OpenSSL, and GNU WGet
- Uninstalls any prior versions of .NET CLI
- Downloads and installs a preview version of .NET Core SDK 2.0 to `~/.dotnet`
- Downloads and installs .NET Core SDK to `~/.dotnet`
If you want to use `dotnet` outside of `Start-PSBuild`,
add `~/.dotnet` to your `PATH` environment variable.

View file

@ -23,9 +23,9 @@ different implementations of PowerShell.
to install PowerShell Core for the distribution and version of Linux you're running.
You can get that version info by running the command `lsb_release -a` from the WSL console.
* .NET Core 2.0 SDK
* .NET Core 2.x SDK
Download and install the [.NET Core 2.0 SDK][net-core-sdk] for your operating system.
Download and install the [.NET Core 2.x SDK][net-core-sdk] for your operating system.
It is recommended that you use a package manager to install the SDK on Linux.
See these [instructions][linux-install] on how to install the SDK on Linux.
Be sure to pick your distribution of Linux e.g. RHEL, Debian, etc to get the
@ -40,7 +40,7 @@ different implementations of PowerShell.
```
This should output `2.0.0` or higher. If it returns a major version of 1, make sure you have
installed the .NET Core 2.0 SDK and have restarted your shell to get the newer version of
installed the .NET Core 2.x SDK and have restarted your shell to get the newer version of
the SDK tools.
1. Use the `dotnet` CLI to create a starter `classlib` project based on .NET Standard 2.0
@ -114,7 +114,7 @@ different implementations of PowerShell.
## Using a .NET Standard 2.0 based binary module in Windows PowerShell
You may have heard that a .NET assembly compiled as a .NET Standard 2.0 class library
will load into both .NET Core 2.0 applications such as PowerShell Core and
will load into both .NET Core 2.x applications such as PowerShell Core and
.NET Framework 4.6.1 (or higher) applications such as Windows PowerShell.
This allows you to build a single, cross-platform binary module.
@ -171,14 +171,15 @@ can't find the `netstandard.dll` "implementation" assembly for the version of th
### The fix for missing netstandard.dll
If you install (or already have) the .NET Core 2.0 SDK for Windows, you can
If you install (or already have) the .NET Core SDK for Windows, you can
find the `netstandard.dll` implementation assembly for .NET 4.6.1 in the following directory:
`C:\Program Files\dotnet\sdk\2.0.0\Microsoft\Microsoft.NET.Build.Extensions\net461\lib`.
`C:\Program Files\dotnet\sdk\<version-number>\Microsoft\Microsoft.NET.Build.Extensions\net461\lib`.
Note that, the version number in the path may vary depending on the installed SDK.
If you copy `netstandard.dll` from this directory to the directory containing
`MyModule.dll`, the `Write-TimestampedMessage` command will work. Let's try that.
1. Install the [.NET Core SDK 2.0 for Windows][net-core-sdk], if it isn't already installed.
1. Install [.NET Core SDK for Windows][net-core-sdk], if it isn't already installed.
1. Start a new Windows PowerShell console. Remember that once a binary assembly is
loaded into PowerShell it can't be unloaded. Restarting PowerShell is necessary to
@ -187,7 +188,7 @@ If you copy `netstandard.dll` from this directory to the directory containing
1. Copy the `netstandard.dll` implementation assembly for .NET 4.6.1 to the module's directory.
```powershell
cd 'path-to-where-you-copied-module.dll'
Copy-Item 'C:\Program Files\dotnet\sdk\2.0.0\Microsoft\Microsoft.NET.Build.Extensions\net461\lib\netstandard.dll' .
Copy-Item 'C:\Program Files\dotnet\sdk\<version-number>\Microsoft\Microsoft.NET.Build.Extensions\net461\lib\netstandard.dll' .
```
1. Import the module and execute the command:
@ -211,7 +212,7 @@ class library that will run in PowerShell Core on multiple operating systems.
It will also run in Windows PowerShell on Windows systems that have been updated to
.NET Framework 4.7.1 as well as the Windows 10 Fall Creators Update which comes with that
version pre-installed. Furthermore, this binary module can be built on Linux
and macOS as well as Windows using the .NET Core 2.0 SDK command-line tools.
and macOS as well as Windows using the .NET Core 2.x SDK command-line tools.
For more information on .NET Standard, check out the [documentation][net-std-docs]
and the [.NET Standard YouTube channel][net-std-chan].

View file

@ -1,6 +1,6 @@
# WebListener App
ASP.NET Core 2.0 app for testing HTTP and HTTPS Requests.
ASP.NET Core app for testing HTTP and HTTPS Requests.
## Run with `dotnet`

View file

@ -3,7 +3,7 @@
<Import Project="..\..\Test.Common.props"/>
<PropertyGroup>
<Description>A simple ASP.NET Core 2.0 MVC app to provide an HTTP and HTTPS server for testing.</Description>
<Description>A simple ASP.NET Core MVC app to provide an HTTP and HTTPS server for testing.</Description>
</PropertyGroup>
<ItemGroup>