functions/Install-DotNetTool.ps1
|
# <copyright file="Install-DotNetTool.ps1" company="Endjin Limited"> # Copyright (c) Endjin Limited. All rights reserved. # </copyright> <# .SYNOPSIS Simple wrapper to install a .NET global tool if it is not already installed. .DESCRIPTION Simple wrapper to install a .NET Global Tool if it is not already installed. Any existing installed version will be uninstalled before installing the required version. .EXAMPLE PS C:\> <example usage> Explanation of what the example does .PARAMETER Name The name of the .NET global tool to install .PARAMETER Version The version of the global tool to install. When unspecified the latest version will attempted to used, however, this does not work for all scenarios (e.g. pre-release, when not using a fully-featured NuGet feed as a source). .PARAMETER AdditionalArgs An array of arbitrary command-line arguments supported by 'dotnet tool install' .PARAMETER Global When specified, the tool is installed in the global scope (i.e. for the current user). .PARAMETER Local When specified, the tool is installed in the local scope (i.e. for the current project's .NET tool manifest). .PARAMETER ToolPath When specified, the tool is installed in the specified directory. #> function Install-DotNetTool { [CmdletBinding(DefaultParameterSetName="global")] param ( [Parameter(Mandatory=$true)] [string] $Name, [Parameter()] [string] $Version, [Parameter()] [string[]] $AdditionalArgs = @(), [Parameter(ParameterSetName="global")] [switch] $Global, [Parameter(ParameterSetName="local")] [switch] $Local, [Parameter(ParameterSetName="toolpath")] [string] $ToolPath ) # Remove AdditionArgs from the bound parameters so we can splat the Test-DotNetTool call $PSBoundParameters.Remove("AdditionalArgs") | Out-Null $alreadyInstalled = Test-DotNetTool @PSBoundParameters # Install the tool, if necessary if (!$alreadyInstalled) { if ($Version) { $AdditionalArgs += @( "--version" $Version ) } switch ($PSCmdlet.ParameterSetName) { "global" { $scopeArg = @("--global") } "local" { $scopeArg = @("--local") } "toolpath" { $scopeArg = @("--tool-path", $ToolPath) } } # Remove any 'scope' references that may have been unnecessarily supplied via AdditionalArgs $AdditionalArgs = $AdditionalArgs | ? { $_ -notin @("-g","--global","-l","--local","-t","--tool-path") } Write-Verbose "cmdline: & dotnet tool install $($scopeArg -join " ") $Name $AdditionalArgs" & dotnet tool install @scopeArg $Name @AdditionalArgs if ($LASTEXITCODE -ne 0) { throw "'dotnet tool install' returned a non-zero exit code ($LASTEXITCODE) - check previous output" } } # Ensure .NET global tools are available via the PATH environment variable, if only for the current process if ($PSCmdlet.ParameterSetName -eq "global") { $toolsPath = Join-Path $HOME ".dotnet/tools" if ($toolsPath -notin ($env:PATH -split [IO.Path]::PathSeparator)) { $env:PATH = "{0}{1}{2}" -f $env:PATH, [IO.Path]::PathSeparator, $toolsPath } } } |