Personalizar o seu ambiente de shell

Um perfil do PowerShell é um script que é executado quando o PowerShell é iniciado. Você pode usar o perfil para personalizar o ambiente. Pode:

• Adicionar aliases, funções e variáveis
• módulos de carga
• criar unidades do PowerShell
• Executar comandos arbitrários
• e alterar as configurações de preferência

Colocar essas configurações em seu perfil garante que elas estejam disponíveis sempre que você iniciar o PowerShell em seu sistema.

Nota

Para executar scripts no Windows, a política de execução do PowerShell precisa ser definida como RemoteSigned no mínimo. As políticas de execução não se aplicam ao macOS e Linux. Para obter mais informações, consulte about_Execution_Policy.

A variável $PROFILE

A $PROFILE variável automática armazena os caminhos para os perfis do PowerShell que estão disponíveis na sessão atual.

Há quatro perfis possíveis disponíveis para dar suporte a escopos de usuário diferentes e hosts PowerShell diferentes. Os caminhos totalmente qualificados para cada script de perfil são armazenados nas seguintes propriedades de membro do $PROFILE.

• AllUsersAllHosts
• AllUsersCurrentHost
• CurrentUserAllHosts
• CurrentUserCurrentHost

Você pode criar scripts de perfil que são executados para todos os usuários ou apenas para um usuário, o CurrentUser. Os perfis CurrentUser são armazenados no diretório inicial do usuário.

Também há perfis que são executados para todos os hosts do PowerShell ou hosts específicos. O script de perfil para cada host do PowerShell tem um nome exclusivo para esse host. Por exemplo, o nome do arquivo para o Host de Console padrão no Windows ou o aplicativo de terminal padrão em outras plataformas é Microsoft.PowerShell_profile.ps1. Para Visual Studio Code (VS Code), o nome do arquivo é Microsoft.VSCode_profile.ps1.

Para obter mais informações, consulte about_Profiles.

Por padrão, a referência à $PROFILE variável retorna o caminho para o perfil "Usuário atual, host atual". O caminho dos outros perfis pode ser acessado através das propriedades da $PROFILE variável. Por exemplo:

PS> $PROFILE
C:\Users\user1\Documents\PowerShell\Microsoft.PowerShell_profile.ps1
PS> $PROFILE.AllUsersAllHosts
C:\Program Files\PowerShell\7\profile.ps1

Como criar o seu perfil pessoal

Quando você instala o PowerShell pela primeira vez em um sistema, os arquivos de script de perfil e os diretórios aos quais pertencem não existem. O comando a seguir cria o arquivo de script de perfil "Usuário atual, host atual atual" se ele não existir.

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

O parâmetro Force do New-Item cmdlet cria as pastas necessárias quando elas não existem. Depois de criar o arquivo de script, você pode usar seu editor favorito para personalizar seu ambiente de shell.

Adicionar personalizações ao seu perfil

Os artigos anteriores falaram sobre o uso de preenchimento de guias, preditores de comando e aliases. Esses artigos mostraram os comandos usados para carregar os módulos necessários, criar completadores personalizados, definir ligações de teclas e outras configurações. Esses são os tipos de personalizações que você deseja ter disponíveis em cada sessão interativa do PowerShell. O script de perfil é o local para essas configurações.

A maneira mais simples de editar seu script de perfil é abrir o arquivo em seu editor de código favorito. Por exemplo, o comando a seguir abre o perfil no VS Code.

code $PROFILE

Você também pode usar notepad.exe no Windows, vi no Linux ou em qualquer outro editor de texto.

O script de perfil a seguir tem exemplos para muitas das personalizações mencionadas nos artigos anteriores. Você pode usar qualquer uma dessas configurações em seu próprio perfil.

## 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]: ' }
                elseif ($principal.IsInRole($adminRole)) { "[ADMIN]: " }
                else { '' })
    $body = 'PS ' + $(Get-Location)
    $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

Este script de perfil fornece exemplos para a seguinte personalização:

• Adiciona dois novos PSDrives para as outras seções de registro raiz.
• Cria um prompt personalizado que muda se você estiver executando em uma sessão elevada.
• Configura PSReadLine e adiciona keybinding. As configurações de cor usam o recurso $PSStyle para definir as configurações de cor ANSI.
• Adiciona o preenchimento de guias para a ferramenta dotnet CLI . A ferramenta fornece parâmetros para ajudar a resolver os argumentos de linha de comando. O bloco de script para Register-ArgumentCompleter usa esse recurso para fornecer a conclusão da guia.