自定义 shell 环境

PowerShell 配置文件是在 PowerShell 启动时运行的脚本。 可以使用个人资料自定义环境。 您可以：

• 添加别名、函数和变量
• 加载模块
• 创建 PowerShell 驱动器
• 运行任意命令
• 更改首选项设置

将这些设置放在配置文件中可确保每当在系统上启动 PowerShell 时，它们都可用。

$PROFILE 变量

$PROFILE 自动变量存储当前会话中可用的 PowerShell 配置文件的路径。

有四个可能的配置文件可用于支持不同的用户范围和不同的 PowerShell 主机。 每个配置文件脚本的完全限定路径存储在$PROFILE的以下成员属性中。

• AllUsersAllHosts
• AllUsersCurrentHost
• CurrentUserAllHosts
• 当前用户当前主机

可以创建为所有用户或仅为单个用户CurrentUser运行的配置文件脚本。 CurrentUser 配置文件存储在用户的主目录路径下。 位置会因操作系统及所使用的 PowerShell 版本而有所不同。

默认情况下，引用 $PROFILE 变量将返回“当前用户，当前主机”配置文件的路径。 通过 $PROFILE 变量的属性可以访问其他配置文件路径。 以下命令显示 Windows 上的默认配置文件位置。

PS> $PROFILE | Select-Object *
AllUsersAllHosts       : C:\Program Files\PowerShell\7\profile.ps1
AllUsersCurrentHost    : C:\Program Files\PowerShell\7\Microsoft.PowerShell_profile.ps1
CurrentUserAllHosts    : C:\Users\username\Documents\PowerShell\profile.ps1
CurrentUserCurrentHost : C:\Users\username\Documents\PowerShell\Microsoft.PowerShell_profile.ps1
Length                 : 69

以下命令显示 Ubuntu Linux 上的默认用户配置文件位置。

$PROFILE | Select-Object *

AllUsersAllHosts       : /opt/microsoft/powershell/7/profile.ps1
AllUsersCurrentHost    : /opt/microsoft/powershell/7/Microsoft.PowerShell_profile.ps1
CurrentUserAllHosts    : /home/username/.config/powershell/profile.ps1
CurrentUserCurrentHost : /home/username/.config/powershell/Microsoft.PowerShell_profile.ps1
Length                 : 67

还有为所有 PowerShell 主机或特定主机运行的配置文件。 每个 PowerShell 主机的配置文件脚本具有该主机唯一的名称。 例如，Windows 上的标准控制台主机或其他平台上的默认终端应用程序的文件名为 Microsoft.PowerShell_profile.ps1。 对于 Visual Studio Code（VS Code），文件名为 Microsoft.VSCode_profile.ps1。

有关详细信息，请参阅 about_Profiles。

如何创建个人个人资料

首次在系统上安装 PowerShell 时，配置文件脚本文件和它们所属的目录不存在。 以下命令创建“当前用户，当前主机”配置文件脚本文件（如果不存在）。

if (!(Test-Path -Path $PROFILE)) {
  New-Item -ItemType File -Path $PROFILE -Force
}

cmdlet 的 New-ItemForce 参数在不存在时创建必要的文件夹。 创建脚本文件后，可以使用你喜欢的编辑器自定义 shell 环境。

向个人资料添加个性化设置

前面的文章讨论了如何使用Tab 键自动补全、命令预测器和别名。 这些文章介绍了用于加载所需模块、创建自定义完成程序、定义密钥绑定和其他设置的命令。 这些是希望在每个 PowerShell 交互式会话中可用的自定义类型。 配置文件脚本是这些设置的所在。

编辑配置文件脚本的最简单方法是在喜欢的代码编辑器中打开该文件。 例如，以下命令在 VS Code 中打开配置文件。

code $PROFILE

还可以在 Windows 中使用 notepad.exe，在 Linux 中使用 vi，或任何其他文本编辑器。

以下配置文件脚本包含前面文章中提到的许多自定义项的示例。 可以在您的个人配置文件中使用这些设置中的任何一个。

## Map PSDrives to other registry hives
if (!(Test-Path HKCR:)) {
    $null = New-PSDrive -Name HKCR -PSProvider Registry -Root HKEY_CLASSES_ROOT
    $null = New-PSDrive -Name HKU -PSProvider Registry -Root HKEY_USERS
}

## Customize the prompt
function prompt {
    $identity = [Security.Principal.WindowsIdentity]::GetCurrent()
    $principal = [Security.Principal.WindowsPrincipal] $identity
    $adminRole = [Security.Principal.WindowsBuiltInRole]::Administrator

    $prefix = if (Test-Path Variable:/PSDebugContext) { '[DBG]: ' } else { '' }
    if ($principal.IsInRole($adminRole)) {
        $prefix = "[ADMIN]:$prefix"
    }
    $body = 'PS ' + $PWD.path
    $suffix = $(if ($NestedPromptLevel -ge 1) { '>>' }) + '> '
    "${prefix}${body}${suffix}"
}

## Create $PSStyle if running on a version older than 7.2
## - Add other ANSI color definitions as needed

if ($PSVersionTable.PSVersion.ToString() -lt '7.2.0') {
    # define escape char since "`e" may not be supported
    $esc = [char]0x1b
    $PSStyle = [pscustomobject]@{
        Foreground = @{
            Magenta = "${esc}[35m"
            BrightYellow = "${esc}[93m"
        }
        Background = @{
            BrightBlack = "${esc}[100m"
        }
    }
}

## Set PSReadLine options and keybindings
$PSROptions = @{
    ContinuationPrompt = '  '
    Colors             = @{
        Operator         = $PSStyle.Foreground.Magenta
        Parameter        = $PSStyle.Foreground.Magenta
        Selection        = $PSStyle.Background.BrightBlack
        InLinePrediction = $PSStyle.Foreground.BrightYellow + $PSStyle.Background.BrightBlack
    }
}
Set-PSReadLineOption @PSROptions
Set-PSReadLineKeyHandler -Chord 'Ctrl+f' -Function ForwardWord
Set-PSReadLineKeyHandler -Chord 'Enter' -Function ValidateAndAcceptLine

## Add argument completer for the dotnet CLI tool
$scriptblock = {
    param($wordToComplete, $commandAst, $cursorPosition)
    dotnet complete --position $cursorPosition $commandAst.ToString() |
        ForEach-Object {
            [System.Management.Automation.CompletionResult]::new($_, $_, 'ParameterValue', $_)
        }
}
Register-ArgumentCompleter -Native -CommandName dotnet -ScriptBlock $scriptblock

此配置脚本提供以下个性化自定义的示例：

• 为其它根注册表蜂巢添加两个新的 PSDrive。
• 在提升的会话中运行时，创建一个 自定义提示 ，该提示会更改。
• 配置 PSReadLine 并添加密钥绑定。 颜色设置使用 $PSStyle 功能定义 ANSI 颜色设置。
• 添加 dotnet CLI 工具的命令行自动补全功能。 该工具提供参数来帮助解析命令行参数。 Register-ArgumentCompleter 的脚本块使用该功能提供选项卡完成。