PowerShell最佳使用实践

scoop bucket add extras
scoop install windows-terminal
# update
scoop update windows-terminal

winget install Microsoft.PowerShell
# or
winget upgrade Microsoft.PowerShell

❯ $PSVersionTable

Name                           Value
----                           -----
PSVersion                      7.2.5
PSEdition                      Core
GitCommitId                    7.2.5
OS                             Microsoft Windows 10.0.25151
Platform                       Win32NT
PSCompatibleVersions           {1.0, 2.0, 3.0, 4.0…}
PSRemotingProtocolVersion      2.3
SerializationVersion           1.1.0.1
WSManStackVersion              3.0

# posh-git 是一个提供 Git/PowerShell 集成的 PowerShell 模块
Install-Module posh-git -Scope CurrentUser
# 适用于任何 shell 的提示主题引擎，美化作用
Install-Module oh-my-posh -Scope CurrentUser
# 一个提供快速注册 tab-completion 和添加别名的模块
Install-Module Register-Completion -Scope CurrentUser

if (!(Test-Path $profile)) {
    New-Item $profile -Force
}
notepad $profile
# 如果有使用 vscode，推荐通过 vscode 打开
code $profile

# 设置 oh-my-posh 主题
Set-PoshPrompt -Theme paradox

chcp 936

# 设置预测文本来源为历史记录，（推荐）
Set-PSReadLineOption -PredictionSource History

# 每次回溯输入历史，光标定位于输入内容末尾
Set-PSReadLineOption -HistorySearchCursorMovesToEnd

# 设置 Tab 为菜单补全和 Intellisense，（推荐）
Set-PSReadLineKeyHandler -Key "Tab" -Function MenuComplete

# 设置向上键为后向搜索历史记录
Set-PSReadLineKeyHandler -Key UpArrow -Function HistorySearchBackward

# 设置向下键为前向搜索历史纪录
Set-PSReadLineKeyHandler -Key DownArrow -Function HistorySearchForward

Register-Alias ll ls
Register-Alias la ls
Register-Alias np notepad
Register-Alias swd "echo $pwd"
Register-Alias apps "cd ~/Projects"
Register-Alias i "cd ~/Projects/$($args[0])"
Register-Alias which Get-Command
Register-Alias ip "ipconfig /all | findstr '192'"
# 可以查看所有通过此方式注册的所有 Alias，除了纯粹的别名外（ll,la,np这种）
Register-Alias myAlias "Get-Command -CommandType Function -Name '*AliasFunction'"

# 下面命令请勿用双引号包裹
Register-Alias nc '"$args" | Invoke-Expression'
# 下面命令，仅做演示用，真实场景可用于 ssh 命令或者真正的常用命令
New-Completion nc @{
   'scoop update' = @{'#tooltip' = 'Update scoop'};
   'winget upgrade' = @{'#tooltip' = 'Upgrade winget'};
}

# https://github.com/microsoft/winget-cli/blob/master/doc/Completion.md
Register-ArgumentCompleter -Native -CommandName winget -ScriptBlock {
   param($wordToComplete, $commandAst, $cursorPosition)
   [Console]::InputEncoding = [Console]::OutputEncoding = $OutputEncoding = [System.Text.Utf8Encoding]::new()

   $word = $wordToComplete.Replace('"', '""')
   $ast = $commandAst.ToString().Replace('"', '""')
   winget complete --word="$word" --commandline "$ast" --position $cursorPosition | ForEach-Object {
      [System.Management.Automation.CompletionResult]::new($_, $_, 'ParameterValue', $_)
   }
}

function Get-ErrorEvent {
   param
   (
      # suggest today, yesterday, and last week:
      [ArgumentCompleter({
            $today = Get-Date -Format 'yyyy-MM-dd'
            $yesterday = (Get-Date).AddDays(-1).ToString('yyyy-MM-dd')
            $lastWeek = (Get-Date).AddDays(-7).ToString('yyyy-MM-dd')

            # create the completions:
            [System.Management.Automation.CompletionResult]::new($today, "Today", "ParameterValue", "all errors after midnight")
            [System.Management.Automation.CompletionResult]::new($yesterday, "Yesterday", "ParameterValue", "all errors after yesterday")
            [System.Management.Automation.CompletionResult]::new($lastWeek, "Last Week", "ParameterValue", "all errors after last week")

         })]
      [DateTime]
      $After
   )

   # forward the parameter -After to Get-EventLog
   # if the user does not specify the parameter, all errors are returned:
   Get-EventLog -LogName System -EntryType Error @PSBoundParameters
}