Skip to content

Commit b3c961f

Browse files
bergmeisterdaxian-dbw
authored andcommitted
Update docs about .NET Core version 2.0 to be about version 2.x (PowerShell#7467)
1 parent 944d716 commit b3c961f

6 files changed

Lines changed: 17 additions & 14 deletions

File tree

.spelling

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -6,6 +6,8 @@
66

77
#region Global Dictionary
88
2ae5d07
9+
2.x
10+
2.x.
911
acl
1012
ActiveDirectory
1113
aditya

demos/WindowsPowerShellModules/README.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@
55
Existing Windows PowerShell users are familiar with the large number of modules available, however, they are not necessarily compatible with PowerShell Core.
66
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/).
77

8-
Windows PowerShell 5.1 is based on .Net Framework 4.6.1, while PowerShell Core is based on .Net Core 2.0.
8+
Windows PowerShell 5.1 is based on .Net Framework 4.6.1, while PowerShell Core is based on .Net Core 2.x.
99
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).
1010

1111
## Importing a Windows PowerShell module

docs/building/macos.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@
33
This guide supplements the [Linux instructions](./linux.md), as
44
building on macOS is almost identical.
55

6-
.NET Core 2.0 (and by transitivity, us) only supports macOS 10.12+.
6+
.NET Core 2.x (and by transitivity, us) only supports macOS 10.12+.
77

88
## Environment
99

@@ -16,7 +16,7 @@ The `Start-PSBootstrap` function does the following:
1616

1717
- Uses `brew` to install CMake, OpenSSL, and GNU WGet
1818
- Uninstalls any prior versions of .NET CLI
19-
- Downloads and installs a preview version of .NET Core SDK 2.0 to `~/.dotnet`
19+
- Downloads and installs .NET Core SDK to `~/.dotnet`
2020

2121
If you want to use `dotnet` outside of `Start-PSBuild`,
2222
add `~/.dotnet` to your `PATH` environment variable.

docs/cmdlet-example/command-line-simple-example.md

Lines changed: 10 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -23,9 +23,9 @@ different implementations of PowerShell.
2323
to install PowerShell Core for the distribution and version of Linux you're running.
2424
You can get that version info by running the command `lsb_release -a` from the WSL console.
2525

26-
* .NET Core 2.0 SDK
26+
* .NET Core 2.x SDK
2727

28-
Download and install the [.NET Core 2.0 SDK][net-core-sdk] for your operating system.
28+
Download and install the [.NET Core 2.x SDK][net-core-sdk] for your operating system.
2929
It is recommended that you use a package manager to install the SDK on Linux.
3030
See these [instructions][linux-install] on how to install the SDK on Linux.
3131
Be sure to pick your distribution of Linux e.g. RHEL, Debian, etc to get the
@@ -40,7 +40,7 @@ different implementations of PowerShell.
4040
```
4141

4242
This should output `2.0.0` or higher. If it returns a major version of 1, make sure you have
43-
installed the .NET Core 2.0 SDK and have restarted your shell to get the newer version of
43+
installed the .NET Core 2.x SDK and have restarted your shell to get the newer version of
4444
the SDK tools.
4545

4646
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.
114114
## Using a .NET Standard 2.0 based binary module in Windows PowerShell
115115

116116
You may have heard that a .NET assembly compiled as a .NET Standard 2.0 class library
117-
will load into both .NET Core 2.0 applications such as PowerShell Core and
117+
will load into both .NET Core 2.x applications such as PowerShell Core and
118118
.NET Framework 4.6.1 (or higher) applications such as Windows PowerShell.
119119
This allows you to build a single, cross-platform binary module.
120120

@@ -171,14 +171,15 @@ can't find the `netstandard.dll` "implementation" assembly for the version of th
171171

172172
### The fix for missing netstandard.dll
173173

174-
If you install (or already have) the .NET Core 2.0 SDK for Windows, you can
174+
If you install (or already have) the .NET Core SDK for Windows, you can
175175
find the `netstandard.dll` implementation assembly for .NET 4.6.1 in the following directory:
176-
`C:\Program Files\dotnet\sdk\2.0.0\Microsoft\Microsoft.NET.Build.Extensions\net461\lib`.
176+
`C:\Program Files\dotnet\sdk\<version-number>\Microsoft\Microsoft.NET.Build.Extensions\net461\lib`.
177+
Note that, the version number in the path may vary depending on the installed SDK.
177178

178179
If you copy `netstandard.dll` from this directory to the directory containing
179180
`MyModule.dll`, the `Write-TimestampedMessage` command will work. Let's try that.
180181

181-
1. Install the [.NET Core SDK 2.0 for Windows][net-core-sdk], if it isn't already installed.
182+
1. Install [.NET Core SDK for Windows][net-core-sdk], if it isn't already installed.
182183

183184
1. Start a new Windows PowerShell console. Remember that once a binary assembly is
184185
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
187188
1. Copy the `netstandard.dll` implementation assembly for .NET 4.6.1 to the module's directory.
188189
```powershell
189190
cd 'path-to-where-you-copied-module.dll'
190-
Copy-Item 'C:\Program Files\dotnet\sdk\2.0.0\Microsoft\Microsoft.NET.Build.Extensions\net461\lib\netstandard.dll' .
191+
Copy-Item 'C:\Program Files\dotnet\sdk\<version-number>\Microsoft\Microsoft.NET.Build.Extensions\net461\lib\netstandard.dll' .
191192
```
192193

193194
1. Import the module and execute the command:
@@ -211,7 +212,7 @@ class library that will run in PowerShell Core on multiple operating systems.
211212
It will also run in Windows PowerShell on Windows systems that have been updated to
212213
.NET Framework 4.7.1 as well as the Windows 10 Fall Creators Update which comes with that
213214
version pre-installed. Furthermore, this binary module can be built on Linux
214-
and macOS as well as Windows using the .NET Core 2.0 SDK command-line tools.
215+
and macOS as well as Windows using the .NET Core 2.x SDK command-line tools.
215216

216217
For more information on .NET Standard, check out the [documentation][net-std-docs]
217218
and the [.NET Standard YouTube channel][net-std-chan].

test/tools/WebListener/README.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# WebListener App
22

3-
ASP.NET Core 2.0 app for testing HTTP and HTTPS Requests.
3+
ASP.NET Core app for testing HTTP and HTTPS Requests.
44

55
## Run with `dotnet`
66

test/tools/WebListener/WebListener.csproj

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@
33
<Import Project="..\..\Test.Common.props"/>
44

55
<PropertyGroup>
6-
<Description>A simple ASP.NET Core 2.0 MVC app to provide an HTTP and HTTPS server for testing.</Description>
6+
<Description>A simple ASP.NET Core MVC app to provide an HTTP and HTTPS server for testing.</Description>
77
</PropertyGroup>
88

99
<ItemGroup>

0 commit comments

Comments
 (0)