Dela via

about_Prompts

  • Artikel

Kort beskrivning

Beskriver funktionen Prompt och visar hur du skapar en anpassad Prompt funktion.

Lång beskrivning

PowerShell-kommandotolken anger att PowerShell är redo att köra ett kommando:

PS C:\>

PowerShell-prompten bestäms av den inbyggda Prompt funktionen. Du kan anpassa prompten genom att skapa en egen Prompt funktion och spara den i PowerShell-profilen.

Om funktionen Prompt

Funktionen Prompt avgör utseendet på PowerShell-prompten. PowerShell levereras med en inbyggd Prompt funktion, men du kan åsidosätta den genom att definiera din egen Prompt funktion.

Funktionen Prompt har följande syntax:

function Prompt { <function-body> }

Funktionen Prompt måste returnera ett objekt. Vi rekommenderar att du returnerar en sträng eller ett objekt som är formaterat som en sträng. Den maximala rekommenderade längden är 80 tecken.

Följande funktion returnerar till exempel strängen Prompt "Hello, World" följt av en höger vinkelparentes (>).

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

Hämta funktionen Prompt

Om du vill hämta Prompt funktionen använder du cmdleten Get-Command eller cmdleten Get-Item på funktionsenheten.

Exempel:

PS C:\> Get-Command Prompt

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

Om du vill hämta skriptet som anger värdet för prompten använder du dot-metoden för att hämta egenskapen ScriptBlock för Prompt funktionen.

Exempel:

(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

Precis som med alla funktioner Prompt lagras funktionen i Function: enheten. Om du vill visa skriptet som skapar den aktuella Prompt funktionen skriver du:

(Get-Item function:prompt).ScriptBlock

Standardprompten

Standardprompten Prompt visas bara när funktionen genererar ett fel eller inte returnerar ett objekt.

Standardprompten för PowerShell är:

PS>

Följande kommando anger Prompt till exempel funktionen till $null, vilket är ogiltigt. Därför visas standardprompten.

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

Eftersom PowerShell levereras med en inbyggd prompt visas vanligtvis inte standardprompten.

Inbyggd prompt

PowerShell innehåller en inbyggd Prompt funktion.

function prompt {
    $(if (Test-Path variable:/PSDebugContext) { '[DBG]: ' }
      else { '' }) + 'PS ' + $(Get-Location) +
        $(if ($NestedPromptLevel -ge 1) { '>>' }) + '> '
}

Funktionen använder cmdleten Test-Path för att avgöra om den $PSDebugContext automatiska variabeln är ifylld. Om $PSDebugContext är ifyllt är du i felsökningsläge och [DBG]: läggs till i prompten på följande sätt:

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

Om $PSDebugContext inte har fyllts i läggs PS funktionen till i prompten. Och funktionen använder cmdleten Get-Location för att hämta den aktuella platsen för filsystemets katalog. Sedan lägger den till en höger vinkelparentes (>).

Exempel:

PS C:\ps-test>

Om du är i en kapslad prompt lägger funktionen till två vinkelparenteser (>>) i prompten. Du är i en kapslad fråga om värdet för den $NestedPromptLevel automatiska variabeln är större än 0.

När du till exempel felsöker i en kapslad fråga liknar prompten följande fråga:

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

Ändringar i prompten

Cmdleten Enter-PSSession förbereder namnet på fjärrdatorn till den aktuella Prompt funktionen. När du använder cmdleten Enter-PSSession för att starta en session med en fjärrdator ändras kommandotolken så att namnet på fjärrdatorn inkluderas. Exempel:

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

Andra PowerShell-värdprogram och alternativa gränssnitt kan ha egna anpassade kommandotolk.

Mer information om $PSDebugContext och $NestedPromptLevel automatiska variabler finns i about_Automatic_Variables.

Så här anpassar du prompten

Om du vill anpassa prompten skriver du en ny Prompt funktion. Funktionen är inte skyddad, så du kan skriva över den.

Skriv följande för att skriva en Prompt funktion:

function prompt { }

Mellan klammerparenteserna anger du sedan kommandona eller strängen som skapar prompten.

Följande uppmaning innehåller till exempel datornamnet:

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

På Server01-datorn liknar prompten följande fråga:

PS [Server01] >

Följande Prompt funktion innehåller aktuellt datum och tid:

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

Prompten liknar följande uppmaning:

03/15/2012 17:49:47>

Du kan också ändra standardfunktionen Prompt :

Till exempel lägger [ADMIN]: följande ändrade Prompt funktion till den inbyggda PowerShell-prompten när PowerShell öppnas med alternativet Kör som administratör:

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

När du startar PowerShell med alternativet Kör som administratör visas en uppmaning som liknar följande uppmaning:

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

Följande Prompt funktion visar historik-ID för nästa kommando. Om du vill visa kommandohistoriken använder du cmdleten 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 >"
}

Följande prompt använder Write-Host cmdletarna och Get-Random för att skapa en uppmaning som ändrar färg slumpmässigt. Eftersom Write-Host skrivningar till det aktuella värdprogrammet men inte returnerar ett objekt innehåller den här funktionen en Return -instruktion. Utan den använder PowerShell standardprompten, PS>.

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

Spara funktionen Prompt

Precis som alla funktioner Prompt finns funktionen bara i den aktuella sessionen. Om du vill spara Prompt funktionen för framtida sessioner lägger du till den i dina PowerShell-profiler. Mer information om profiler finns i about_Profiles.

Se även