Delen via

Push-Location

  • Referentie
Module:
Microsoft.PowerShell.Management

Hiermee voegt u de huidige locatie toe aan de bovenkant van een locatiestack.

Syntaxis

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

Description

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 cmdlet Push-Location pusht de huidige locatie standaard 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 notities voor meer informatie over locatiestacks.

Voorbeelden

Voorbeeld 1

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

Voorbeeld 2

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.

Voorbeeld 3

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

PS C:\> Push-Location

Voorbeeld 4: Een benoemde stack maken en gebruiken

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:\>

De eerste opdracht pusht de huidige locatie naar een nieuwe stack met de naam Stack2 en wijzigt vervolgens de huidige locatie in de basismap, die wordt weergegeven in de opdracht door het tilde-symbool (~) (hetzelfde als $env:USERPROFILE of $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 (PS 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.

Parameters

-LiteralPath

Hiermee geeft u het pad naar de nieuwe locatie. In tegenstelling tot de parameter Path, wordt de waarde van de parameter LiteralPath exact gebruikt zoals deze is getypt. Er worden geen tekens geïnterpreteerd als jokertekens. Als het pad escapetekens bevat, plaatst u het tussen enkele aanhalingstekens. Enkele aanhalingstekens geven Windows PowerShell aan dat er geen tekens als escapereeksen moeten worden geïnterpreteerd.

Type:String
Aliassen:PSPath
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-PassThru

Geeft een object door dat de locatie aan de pijplijn vertegenwoordigt. Deze cmdlet genereert standaard geen uitvoer.

Type:SwitchParameter
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Path

Wijzigt uw locatie in de locatie die door dit pad is opgegeven nadat deze de huidige locatie boven aan de stapel heeft toegevoegd (gepusht). Voer een pad in naar een locatie waarvan de provider deze cmdlet ondersteunt. Jokertekens zijn toegestaan. De parameternaam is optioneel.

Type:String
Position:1
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:True

-StackName

Hiermee geeft u de locatiestack waaraan de huidige locatie wordt toegevoegd. Voer de naam van een locatiestack in. Als de stack niet bestaat, Push-Location deze maakt.

Zonder deze parameter voegt Push-Location de locatie toe aan de huidige locatiestack. De huidige locatiestack is standaard de niet-benoemde standaardlocatiestack die door PowerShell wordt gemaakt. Als u een locatiestack de huidige locatiestack wilt maken, gebruikt u de parameter StackName van de cmdlet Set-Location. Zie de Notitiesvoor meer informatie over locatiestacks.

Notitie

Push-Location kan geen locatie toevoegen aan de niet-benoemde standaardstack, tenzij dit de huidige locatiestack is.

Type:String
Position:Named
Default value:Default stack
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-UseTransaction

Bevat de opdracht in de actieve transactie. Deze parameter is alleen geldig wanneer een transactie wordt uitgevoerd. Zie about_Transactionsvoor meer informatie.

Type:SwitchParameter
Aliassen:usetx
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

Invoerwaarden

String

U kunt een tekenreeks die een pad bevat (maar geen letterlijk pad) doorsluisen naar Push-Location.

Uitvoerwaarden

None or System.Management.Automation.PathInfo

Wanneer u de parameter PassThru gebruikt, genereert Push-Location een System.Management.Automation.PathInfo object dat de locatie vertegenwoordigt. Anders genereert deze cmdlet geen uitvoer.

Notities

Een 'stack' is een 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 Windows 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 Push-Location of Pop-Location cmdlets toevoegen of ophalen uit de standaardstack of Get-Location opdracht 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.