about_Prompts

  • Статья

Краткое описание

Prompt Описывает функцию и демонстрирует создание пользовательской Prompt функции.

Подробное описание

Командная строка PowerShell указывает, что PowerShell готова к выполнению команды:

PS C:\>

PowerShell имеет встроенную Prompt функцию. Вы можете определить собственную настраиваемую Prompt функцию в скрипте профиля PowerShell.

Сведения о функции "Запрос"

Функция Prompt определяет внешний вид запроса PowerShell. PowerShell поставляется со встроенной Prompt функцией, но ее можно переопределить, определив собственную Prompt функцию.

Функция Prompt имеет следующий синтаксис:

function Prompt { <function-body> }

Функция Prompt должна возвращать объект. Рекомендуется возвращать строку или объект, отформатированный как строку. Максимальная рекомендуемая длина — 80 символов.

Например, следующая Prompt функция возвращает строку Hello, World, за которой следует угловая скобка (>).

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

Получение функции "Запрос"

Чтобы получить функцию Prompt , используйте командлет или используйте Get-CommandGet-Item командлет на диске функции.

Например:

PS C:\> Get-Command Prompt

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

Чтобы получить скрипт, который задает значение запроса, используйте метод dot для получения свойства Prompt ScriptBlock функции.

Например:

(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

Как и все функции, Prompt функция хранится на Function: диске. Чтобы отобразить скрипт, создающий текущую Prompt функцию, введите:

(Get-Item function:prompt).ScriptBlock

Запрос по умолчанию

Запрос по умолчанию отображается только в том случае, если Prompt функция создает ошибку или не возвращает объект.

Запрос PowerShell по умолчанию:

PS>

Например, следующая команда задает Prompt для функции $nullнедопустимое значение. В результате появится запрос по умолчанию.

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

Так как PowerShell поставляется со встроенным запросом, обычно не отображается запрос по умолчанию.

Встроенный запрос

PowerShell включает встроенную 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
}

Функция использует Test-Path командлет для проверки наличия значения автоматической $PSDebugContext переменной. Если $PSDebugContext имеется значение, выполняется в режиме отладки и [DBG]: добавляется в запрос следующим образом:

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

Если $PSDebugContext функция не заполнена, функция добавляется PS в запрос. И функция использует Get-Location командлет для получения текущего расположения каталога файловой системы. Затем он добавляет прямоугольную угловую скобку (>).

Например:

PS C:\ps-test>

Если вы находитесь в вложенном запросе, функция добавляет две угловые скобки (>>) в запрос. Если значение автоматической переменной $NestedPromptLevel больше 0, отображается вложенном запросе.

Например, при отладке в вложенном запросе запрос похож на следующий запрос:

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

Изменения в запросе

Командлет Enter-PSSession добавляет имя удаленного компьютера в текущую Prompt функцию. При использовании Enter-PSSession командлета для запуска сеанса с удаленным компьютером командная строка изменяет имя удаленного компьютера. Например:

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

Другие приложения и альтернативные оболочки PowerShell могут иметь собственные пользовательские командные строки.

Дополнительные сведения о переменных и автоматических $PSDebugContext переменных см. в about_Automatic_Variables.$NestedPromptLevel

Настройка запроса

Чтобы настроить запрос, напишите новую Prompt функцию. Функция не защищена, поэтому ее можно перезаписать.

Чтобы написать функцию Prompt , введите следующее:

function prompt { }

Затем между фигурными скобками введите команды или строку, которая создает запрос.

Например, следующий запрос содержит имя компьютера:

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

На компьютере Server01 запрос похож на следующий запрос:

PS [Server01] >

Следующая Prompt функция включает текущую дату и время:

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

Запрос похож на следующий запрос:

03/15/2012 17:49:47>

Вы также можете изменить функцию по умолчанию Prompt :

Например, следующая измененная Prompt функция добавляется [ADMIN]: в встроенный запрос PowerShell при выполнении в сеансе с повышенными привилегиями.

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) { '>>' }) + '> '
}

При запуске PowerShell с помощью параметра "Запуск от имени администратора" появится запрос, похожий на следующий запрос:

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

Prompt Следующая функция отображает идентификатор журнала следующей команды. Чтобы просмотреть журнал команд, используйте Get-History командлет.

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 >"
}

Следующая строка использует Write-Host командлеты и Get-Random командлеты для создания запроса, изменяющего цвет случайным образом. Так как Write-Host записывается в текущее приложение узла, но не возвращает объект, эта функция включает инструкцию Return . Без этого PowerShell использует запрос PS>по умолчанию.

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

Сохранение функции запроса

Как и любая функция, Prompt функция существует только в текущем сеансе. Чтобы сохранить функцию Prompt для будущих сеансов, добавьте ее в профили PowerShell. Дополнительные сведения о профилях см. в about_Profiles.

См. также