Push-Location

Push-Location
    [[-Path] <String>]
    [-PassThru]
    [-StackName <String>]
    [<CommonParameters>]

Push-Location
    [-LiteralPath <String>]
    [-PassThru]
    [-StackName <String>]
    [<CommonParameters>]

Cmdleten Push-Location lägger till ("pushar") den aktuella platsen till en platsstacken. Om du anger en sökväg skickar Push-Location den aktuella platsen till en platsstacken och ändrar sedan den aktuella platsen till den plats som anges av sökvägen. Du kan använda cmdleten Pop-Location för att hämta platser från platsstacken.

Som standard skickar cmdleten Push-Location den aktuella platsen till den aktuella platsstacken, men du kan använda parametern StackName för att ange en alternativ platsstacken. Om stacken inte finns skapar Push-Location den.

Mer information om platsstackar finns i Anteckningar.

Det här exemplet skickar den aktuella platsen till standardplatsstacken och ändrar sedan platsen till C:\Windows.

PS C:\> Push-Location C:\Windows

Det här exemplet skickar den aktuella platsen till RegFunction-stacken och ändrar den aktuella platsen till den HKLM:\Software\Policies platsen.

PS C:\> Push-Location HKLM:\Software\Policies -StackName RegFunction

Du kan använda cmdletarna Location i valfri PowerShell-enhet (PSDrive).

Det här kommandot skickar den aktuella platsen till standardstacken. Den ändrar inte platsen.

PS C:\> Push-Location

Dessa kommandon visar hur du skapar och använder en namngiven platsstacken.

PS C:\> Push-Location ~ -StackName Stack2
PS C:\Users\User01> Pop-Location -StackName Stack2
PS C:\>

Det första kommandot skickar den aktuella platsen till en ny stack med namnet Stack2 och ändrar sedan den aktuella platsen till hemkatalogen, som representeras i kommandot av tilde-symbolen (~), som när den används på en FileSystem-providerenheter motsvarar $HOME.

Om Stack2 inte redan finns i sessionen skapar Push-Location den. Det andra kommandot använder cmdleten Pop-Location för att öppna den ursprungliga platsen (C:\) från Stack2-stacken. Utan parametern StackName skulle Pop-Location öppna platsen från den namnlösa standardstacken.

Mer information om platsstackar finns i Anteckningar.

Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.

Du kan skicka en sträng som innehåller en sökväg (men inte en literal sökväg) till den här cmdleten.

Som standard returnerar den här cmdleten inga utdata.

När du använder parametern PassThru returnerar den här cmdleten ett PathInfo- objekt som representerar den aktuella sökvägen efter cmdletens åtgärd.

PowerShell innehåller följande alias för Push-Location:

• Alla plattformar:
  • pushd

PowerShell stöder flera runspaces per process. Varje runspace har sin egen aktuella katalog. Detta är inte samma sak som [System.Environment]::CurrentDirectory. Det här beteendet kan vara ett problem när du anropar .NET-API:er eller kör interna program utan att ange explicita katalogsökvägar.

Även om plats-cmdletarna angav den aktuella katalogen för hela processen kan du inte vara beroende av den eftersom en annan runspace kan ändra den när som helst. Du bör använda plats-cmdletarna för att utföra sökvägsbaserade åtgärder med hjälp av den aktuella arbetskatalogen som är specifik för den aktuella körningsytan.

En stack är en lista med de senaste och första ut där endast det senast tillagda objektet är tillgängligt. Du lägger till objekt i en stack i den ordning du använder dem och hämtar dem sedan för användning i omvänd ordning. Med PowerShell kan du lagra providerplatser i platsstackar.

PowerShell skapar en namnlös standardplatsstack och du kan skapa flera namngivna platsstackar. Om du inte anger ett stacknamn använder PowerShell den aktuella platsstacken. Som standard är den namnlösa standardplatsen den aktuella platsstacken, men du kan använda cmdleten Set-Location för att ändra den aktuella platsstacken.

Om du vill hantera platsstaplar använder du cmdletarna PowerShell-plats enligt följande.

• Om du vill lägga till en plats i en platsstacken använder du cmdleten Push-Location.

• Om du vill hämta en plats från en platsstacken använder du cmdleten Pop-Location.

• Om du vill visa platserna i den aktuella platsstacken använder du parametern Stack i cmdleten Get-Location.

• Om du vill visa platserna i en namngiven platsstacken använder du parametern StackName i cmdleten Get-Location.

• Om du vill skapa en ny platsstacken använder du stackName-parametern för cmdleten Push-Location. Om du anger en stack som inte finns skapar Push-Location stacken.

• Om du vill göra en platsstack till den aktuella platsstacken använder du stackName-parametern för cmdleten Set-Location.

Den namnlösa standardplatsstacken är endast helt tillgänglig när det är den aktuella platsstacken. Om du gör en namngiven platsstacken till den aktuella platsstacken kan du inte längre använda cmdletarna Push-Location eller Pop-Location för att lägga till eller hämta objekt från standardstacken eller använda cmdleten Get-Location för att visa platserna i den namnlösa stacken. Om du vill göra den namnlösa stacken till den aktuella stacken använder du parametern StackName för cmdleten Set-Location med värdet $null eller en tom sträng ("").

Du kan också referera till Push-Location med dess inbyggda alias, pushd. Mer information finns i about_Aliases.

Cmdleten Push-Location är utformad för att fungera med data som exponeras av alla leverantörer. Om du vill visa en lista över tillgängliga leverantörer i sessionen skriver du Get-PSProvider. Mer information finns i om_Leverantörer.