Bump version. Minor fixes.

* Clarify where values for the Product argument can be obtained from.
* Fix `ExcludePrerelease` is ignored by `Get-VisualStudio`
* Fix whitespace
* Add help annotations for `Start-VisualStudio`
* Bump version to 0.4.0

Author: ericwj

Modules/VisualStudioShell/Enter-VisualStudioShell.ps1

@@ -45,7 +45,9 @@ using module VSSetup
 	Suppress printing of the developer command prompt banner.
 
 	.Parameter Product
-	One or more products to select. Wildcards are supported.
+	One or more products to select. Wildcards are supported. (Passed through to Select-VSSetupInstance)
+
+	Run `Get-VSSetupInstance | Select-Object Product` to obtain a list of available valid values albeit with a version number.
 
 	.Parameter StartDirectoryMode
 	The startup directory mode.

Modules/VisualStudioShell/Get-VisualStudio.ps1

@@ -8,7 +8,9 @@ using module VSSetup
 	Do not allow selection of Preview versions of Visual Studio. (Passed through negated to Get-VSSetupInstance)
 
 	.Parameter Product
-	One or more products to select. Wildcards are supported.
+	One or more products to select. Wildcards are supported. (Passed through to Select-VSSetupInstance)
+
+	Run `Get-VSSetupInstance | Select-Object Product` to obtain a list of available valid values albeit with a version number.
 #>
 function Get-VisualStudio {
 	[CmdLetBinding()]
@@ -21,13 +23,13 @@ function Get-VisualStudio {
 	$VS = $null
 	if ($null -eq $Product) {
 		$VS =
-			Get-VSSetupInstance -Prerelease:$(-not $Prerelease.IsPresent) |
+			Get-VSSetupInstance -Prerelease:$(-not $ExcludePrerelease.IsPresent) |
 			Select-VSSetupInstance -Latest |
 			Sort-Object -Property InstallationVersion |
 			Select-Object -Last 1
 	} else {
 		$VS =
-			Get-VSSetupInstance -Prerelease:$(-not $Prerelease.IsPresent) |
+			Get-VSSetupInstance -Prerelease:$(-not $ExcludePrerelease.IsPresent) |
 			Select-VSSetupInstance -Latest -Product:$Product |
 			Sort-Object -Property InstallationVersion |
 			Select-Object -Last 1

Modules/VisualStudioShell/Import-VisualStudioShellModule.ps1

@@ -31,9 +31,9 @@ function Import-VisualStudioShellModule {
 	}
 	function ThrowIfModuleNotFound([string]$ModulePath) {
 		throw [ErrorRecord]::new(
-        	[System.Exception]::new("Required assembly could not be located. This most likely indicates an installation error. Try repairing your Visual Studio installation. Expected location: $modulePath"),
-        	"DevShellModuleLoad",
-        	[ErrorCategory]::NotInstalled,
+			[System.Exception]::new("Required assembly could not be located. This most likely indicates an installation error. Try repairing your Visual Studio installation. Expected location: $modulePath"),
+			"DevShellModuleLoad",
+			[ErrorCategory]::NotInstalled,
 			$VisualStudio)
 	}
 	# Developer PowerShell for VS 2019 Preview

Modules/VisualStudioShell/Start-VisualStudio.ps1

@@ -1,5 +1,25 @@
 #Requires -Module VSSetup
 using module VSSetup
+<#
+	.Synopsis
+	Starts Common7\IDE\devenv.exe in the installation path for the Visual Studio setup instance
+	provided explicitly, or if none was provided, the one selected running Get-VisualStudio.
+
+	.Parameter FileOrFolder
+	The file or folder path to pass as the first argument to devenv.exe. The default is none.
+
+	.Parameter StartInPath
+	The working directory for devenv.exe. Defaults to the current working directory.
+
+	.Parameter ExcludePrerelease
+	Do not allow selection of Preview versions of Visual Studio. (Passed through negated to Get-VSSetupInstance)
+
+	.Parameter VisualStudio
+	A setup instance obtained from the VSSetup PowerShell module.
+
+	.Parameter RemainingArguments
+	Any arguments that will be provided unmodified to devenv.exe.
+#>
 function Start-VisualStudio {
 	[CmdLetBinding(
 		SupportsShouldProcess = $true,
@@ -13,19 +33,26 @@ function Start-VisualStudio {
 
 		[switch]$Force = [switch]::new($false),
 
+		[Parameter(ParameterSetName='select')]
 		[switch]$ExcludePrerelease = [switch]::new($false),
 
+		[Parameter(ParameterSetName='instance')]
 		[Microsoft.VisualStudio.Setup.Instance]$VisualStudio = $null,
 
 		[Parameter(ValueFromRemainingArguments = $true)]
 		[object[]]$RemainingArguments = $null
 	)
 	Process {
-		if ($null -eq $VisualStudio) {
-			$VisualStudio = Get-VisualStudio -ExcludePrerelease:($ExcludePrerelease.IsPresent)
-		} elseif (-not (Confirm-VisualStudio $VisualStudio)) {
-			Write-Error "The Visual Studio parameter is not valid. Remove the parameter or specify a valid value."
-			return;
+		switch ($PSCmdLet.ParameterSetName) {
+			'instance' {
+				if (-not (Confirm-VisualStudio $VisualStudio)) {
+					Write-Error "The Visual Studio parameter is not valid. Remove the parameter or specify a valid value."
+					return;
+				}
+			}
+			default {
+				$VisualStudio = Get-VisualStudio -ExcludePrerelease:($ExcludePrerelease.IsPresent) -Product:$Product
+			}
 		}
 		if (-not (Import-VisualStudioShellModule -VisualStudio $VisualStudio)) {
 			Write-Error "Could not load the Visual Studio Shell module."

Modules/VisualStudioShell/VisualStudioShell.psd1

@@ -6,7 +6,7 @@
 
 @{
 	RootModule            = 'VisualStudioShell.psm1'
-	ModuleVersion         = '0.3.1'
+	ModuleVersion         = '0.4.0'
 	GUID                  = '5ca15b3d-9366-45d7-b366-2a9c1d2bcd25'
 	Author                = 'Eric'
 	CompanyName           = 'Eric'