Push-Location

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

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

De Push-Location cmdlet voegt de huidige locatie toe aan een locatiestack. Als u een pad opgeeft, Push-Location de huidige locatie naar een locatiestack pusht en vervolgens de huidige locatie wijzigt in de locatie die door het pad is opgegeven. U kunt de cmdlet Pop-Location gebruiken om locaties op te halen uit de locatiestack.

De Push-Location cmdlet pusht standaard de huidige locatie naar de huidige locatiestack, maar u kunt de parameter StackName gebruiken om een alternatieve locatiestack op te geven. Als de stack niet bestaat, Push-Location deze maakt.

Zie de Notitiesvoor meer informatie over locatiestacks.

In dit voorbeeld wordt de huidige locatie naar de standaardlocatiestack gepusht en wordt de locatie vervolgens gewijzigd in C:\Windows.

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

In dit voorbeeld wordt de huidige locatie naar de RegFunction-stack gepusht en wordt de huidige locatie gewijzigd in de HKLM:\Software\Policies locatie.

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

U kunt de locatie-cmdlets in elk PowerShell-station (PSDrive) gebruiken.

Met deze opdracht wordt de huidige locatie naar de standaardstack gepusht. De locatie wordt niet gewijzigd.

PS C:\> Push-Location

Deze opdrachten laten zien hoe u een benoemde locatiestack maakt en gebruikt.

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

Met de eerste opdracht wordt de huidige locatie naar een nieuwe stack met de naam Stack2 gepusht en wordt de huidige locatie vervolgens gewijzigd in de basismap, vertegenwoordigd in de opdracht door het tilde-symbool (~), dat bij gebruik op een bestandssysteemproviderstation gelijk is aan $HOME.

Als Stack2 nog niet bestaat in de sessie, Push-Location deze maakt. De tweede opdracht maakt gebruik van de Pop-Location cmdlet om de oorspronkelijke locatie (C:\) uit de Stack2-stack te plaatsen. Zonder de parameter StackName wordt Pop-Location de locatie van de niet-benoemde standaardstack weergegeven.

Zie de Notitiesvoor meer informatie over locatiestacks.

Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.

U kunt een tekenreeks die een pad bevat (maar geen letterlijk pad) doorsluisen naar deze cmdlet.

Deze cmdlet retourneert standaard geen uitvoer.

Wanneer u de parameter PassThru gebruikt, retourneert deze cmdlet een PathInfo--object dat het huidige pad vertegenwoordigt na de bewerking van de cmdlet.

PowerShell bevat de volgende aliassen voor Push-Location:

• Alle platforms:
  • pushd

PowerShell ondersteunt meerdere runspaces per proces. Elke runspace heeft een eigen werkmap. Dit is niet hetzelfde als [System.Environment]::CurrentDirectory. Dit gedrag kan een probleem zijn bij het aanroepen van .NET-API's of het uitvoeren van systeemeigen toepassingen zonder expliciete directorypaden op te geven.

Zelfs als de locatie-cmdlets de huidige map voor het hele proces hebben ingesteld, kunt u er niet van afhankelijk zijn omdat een andere runspace deze op elk gewenst moment kan wijzigen. Gebruik de locatie-cmdlets om padgebaseerde bewerkingen uit te voeren met behulp van de huidige werkmap die specifiek is voor de huidige runspace.

Een stack is een first-in- en first-out lijst waarin alleen het laatst toegevoegde item toegankelijk is. U voegt items toe aan een stapel in de volgorde waarin u ze gebruikt en haalt ze vervolgens op voor gebruik in de omgekeerde volgorde. Met PowerShell kunt u providerlocaties opslaan in locatiestacks.

PowerShell maakt een niet-benoemde standaardlocatiestack en u kunt meerdere benoemde locatiestacks maken. Als u geen stacknaam opgeeft, gebruikt PowerShell de huidige locatiestack. Standaard is de niet-benoemde standaardlocatie de huidige locatiestack, maar u kunt de Set-Location cmdlet gebruiken om de huidige locatiestack te wijzigen.

Als u locatiestacks wilt beheren, gebruikt u de PowerShell-locatie-cmdlets als volgt.

• Gebruik de cmdlet Push-Location om een locatie toe te voegen aan een locatiestack.

• Gebruik de cmdlet Pop-Location om een locatie op te halen uit een locatiestack.

• Als u de locaties in de huidige locatiestack wilt weergeven, gebruikt u de parameter Stack van de Get-Location-cmdlet.

• Als u de locaties in een benoemde locatiestack wilt weergeven, gebruikt u de parameter StackName van de Get-Location-cmdlet.

• Als u een nieuwe locatiestack wilt maken, gebruikt u de parameter StackName van de cmdlet Push-Location. Als u een stack opgeeft die niet bestaat, Push-Location de stack maakt.

• Als u een locatiestack de huidige locatiestack wilt maken, gebruikt u de parameter StackName van de cmdlet Set-Location.

De niet-benoemde standaardlocatiestack is alleen volledig toegankelijk als het de huidige locatiestack is. Als u een benoemde locatiestack maakt, kunt u de huidige locatiestack niet meer gebruiken om de Push-Location of Pop-Location cmdlets toe te voegen of op te halen uit de standaardstack of de Get-Location-cmdlet gebruiken om de locaties in de niet-benoemde stack weer te geven. Als u de niet-benoemde stack de huidige stack wilt maken, gebruikt u de parameter StackName van de Set-Location-cmdlet met een waarde van $null of een lege tekenreeks ("").

U kunt ook verwijzen naar Push-Location door de ingebouwde alias, pushd. Zie about_Aliasesvoor meer informatie.

De cmdlet Push-Location is ontworpen om te werken met de gegevens die door elke provider worden weergegeven. Als u de providers wilt weergeven die beschikbaar zijn in uw sessie, typt u Get-PSProvider. Zie about_Providersvoor meer informatie.