Compartilhar via

about_Prompts

Descrição curta

Descreve a prompt função e demonstra como criar uma função personalizada prompt .

Descrição longa

O prompt de comando do PowerShell indica que o PowerShell está pronto para executar um comando:

PS C:\>

O PowerShell tem uma função interna prompt . Você pode definir sua própria função personalizada prompt no script de perfil do PowerShell.

Sobre a prompt função

A prompt função determina a aparência do prompt do PowerShell. O PowerShell vem com uma função interna prompt , mas você pode substituí-la definindo sua própria prompt função.

A prompt função tem a seguinte sintaxe:

function prompt { <function-body> }

A prompt função deve retornar um objeto. Como prática recomendada, retorne uma cadeia de caracteres ou um objeto formatado como uma cadeia de caracteres. O comprimento máximo recomendado é de 80 caracteres.

Por exemplo, a função a seguir prompt retorna uma cadeia de caracteres "Hello, World" seguida por um colchete angular reto (>).

PS C:\> function prompt {"Hello, World > "}
Hello, World >

Obtendo a função prompt

Para obter a prompt função, use o Get-Command cmdlet ou use o Get-Item cmdlet na unidade de função.

Por exemplo:

PS C:\> Get-Command prompt

CommandType     Name      ModuleName
-----------     ----      ----------
Function        prompt

Para obter o script que define o valor do prompt, use o método dot para obter a propriedade ScriptBlock da prompt função.

Por exemplo:

(Get-Command prompt).ScriptBlock

"PS $($ExecutionContext.SessionState.Path.CurrentLocation)$('>' * ($NestedPromptLevel + 1)) "
# .Link
# https://go.microsoft.com/fwlink/?LinkID=225750
# .ExternalHelp System.Management.Automation.dll-help.xml

Como todas as funções, a função é armazenada promptFunction: na unidade. Para exibir o script que cria a função atual prompt , digite:

(Get-Item Function:prompt).ScriptBlock

O prompt padrão

O prompt padrão aparece somente quando a prompt função gera um erro ou não retorna um objeto.

O prompt padrão do PowerShell é:

PS>

Por exemplo, o comando a seguir define a prompt função como $null, que é inválida. Como resultado, o prompt padrão é exibido.

PS C:\> function prompt {$null}
PS>

Como o PowerShell vem com um prompt interno, você geralmente não vê o prompt padrão.

Prompt integrado

O PowerShell inclui uma função interna prompt .

function prompt {
  "PS $($ExecutionContext.SessionState.Path.CurrentLocation)$('>' * ($NestedPromptLevel + 1)) ";
  # .Link
  # https://go.microsoft.com/fwlink/?LinkID=225750
  # .ExternalHelp System.Management.Automation.dll-help.xml
}

A função usa o Test-Path cmdlet para testar se a $PSDebugContext variável automática tem um valor. Se $PSDebugContext tiver um valor, você estará executando no modo de depuração e [DBG]: será adicionado ao prompt, da seguinte maneira:

[DBG]: PS C:\ps-test>

Se $PSDebugContext não estiver preenchido, a função será adicionada PS ao prompt. E a função usa o Get-Location cmdlet para obter o local atual do diretório do sistema de arquivos. Em seguida, ele adiciona um colchete angular reto (>).

Por exemplo:

PS C:\ps-test>

Se você estiver em um prompt aninhado, a função adicionará dois colchetes angulares (>>) ao prompt. Você está em um prompt aninhado se o valor da $NestedPromptLevel variável automática for maior que 0.

Por exemplo, quando você está depurando em um prompt aninhado, o prompt é semelhante ao seguinte prompt:

[DBG] PS C:\ps-test>>>

Alterações no prompt

O Enter-PSSession cmdlet anexa o nome do computador remoto à função atual prompt . Quando você usa o Enter-PSSession cmdlet para iniciar uma sessão com um computador remoto, o prompt de comando é alterado para incluir o nome do computador remoto. Por exemplo:

PS Hello, World> Enter-PSSession Server01
[Server01]: PS Hello, World>

Outros aplicativos host do PowerShell e shells alternativos podem ter seus próprios prompts de comando personalizados.

Para obter mais informações sobre as variáveis e automáticas, consulte $PSDebugContext.$NestedPromptLevel

Como personalizar o prompt

Para personalizar o prompt, escreva uma nova prompt função. A função não está protegida, portanto, você pode substituí-la.

Para escrever uma prompt função, digite o seguinte:

function prompt { }

Em seguida, entre as chaves, insira os comandos ou a string que cria seu prompt.

Por exemplo, o prompt a seguir inclui o nome do seu computador:

function prompt {"PS [$Env:COMPUTERNAME]> "}

No computador Server01, o prompt é semelhante ao seguinte prompt:

PS [Server01] >

A função a seguir prompt inclui a data e a hora atuais:

function prompt {"$(Get-Date)> "}

O prompt é semelhante ao seguinte prompt:

03/15/2012 17:49:47>

Você também pode alterar a função padrão prompt :

Por exemplo, a função modificada prompt a seguir é adicionada [ADMIN]: ao prompt interno do PowerShell ao ser executada em uma sessão com privilégios elevados.

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

  $(if (Test-Path Variable:/PSDebugContext) { '[DBG]: ' }
    elseif($principal.IsInRole($adminRole)) { "[ADMIN]: " }
    else { '' }
  ) + 'PS ' + $(Get-Location) +
    $(if ($NestedPromptLevel -ge 1) { '>>' }) + '> '
}

Quando você inicia o PowerShell usando a opção Executar como administrador , um prompt semelhante ao seguinte prompt é exibido:

[ADMIN]: PS C:\ps-test>

A função a seguir prompt exibe a ID do histórico do próximo comando. Para exibir o histórico de comandos, use o Get-History cmdlet.

function prompt {
   # The at sign creates an array in case only one history item exists.
   $history = @(Get-History)
   if($history.Count -gt 0)
   {
      $lastItem = $history[$history.Count - 1]
      $lastId = $lastItem.Id
   }

   $nextCommand = $lastId + 1
   $currentDirectory = Get-Location
   "PS: $nextCommand $currentDirectory >"
}

O prompt a seguir usa os Write-Host cmdlets e Get-Random para criar um prompt que muda de cor aleatoriamente. Como Write-Host grava no aplicativo host atual, mas não retorna um objeto, essa função inclui uma return instrução. Sem ele, o PowerShell usa o prompt padrão, PS>.

function prompt {
    $color = Get-Random -Min 1 -Max 16
    Write-Host ("PS " + $(Get-Location) +">") -NoNewline `
     -ForegroundColor $Color
    return " "
}

Salvando a função prompt

Como qualquer função, a prompt função existe apenas na sessão atual. Para salvar a prompt função para sessões futuras, adicione-a aos seus perfis do PowerShell. Para obter mais informações sobre perfis, consulte about_Profiles.

Consulte também

  • Last updated on