Delen via

Set-Location

  • Referentie
Module:
Microsoft.PowerShell.Management

Hiermee stelt u de huidige werklocatie in op een opgegeven locatie.

Syntaxis

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

Description

De Set-Location-cmdlet stelt de werklocatie in op een opgegeven locatie. Deze locatie kan een map, een submap, een registerlocatie of een providerpad zijn.

U kunt ook de parameter StackName gebruiken om een benoemde locatiestack de huidige locatiestack te maken. Zie de notities voor meer informatie over locatiestacks.

Voorbeelden

Voorbeeld 1: De huidige locatie instellen

PS C:\> Set-Location -Path "HKLM:"

PS HKLM:\>

Met deze opdracht wordt de huidige locatie ingesteld op de hoofdmap van het HKLM-station: station.

Voorbeeld 2: De huidige locatie instellen en die locatie weergeven

PS C:\> Set-Location -Path "Env:" -PassThru

Path
----
Env:\

PS Env:\>

Met deze opdracht wordt de huidige locatie ingesteld op de hoofdmap van het Station Env: . Hierbij wordt de parameter PassThru gebruikt om PowerShell te leiden om een PathInfo--object te retourneren dat de locatie Env: vertegenwoordigt.

Voorbeeld 3: Locatie instellen op het station C:

PS C:\> Set-Location C:

Met deze opdracht wordt de huidige locatie C: station ingesteld in de bestandssysteemprovider.

Voorbeeld 4: De huidige locatie instellen op een benoemde stack

PS C:\> Set-Location -StackName "WSManPaths"

Met deze opdracht wordt de WSManPaths-locatie de huidige locatiestack gestapeld.

De *-Location cmdlets gebruiken de huidige locatiestack, tenzij een andere locatiestack is opgegeven in de opdracht. Zie de notities voor informatie over locatiestacks.

Parameters

-LiteralPath

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

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:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-PassThru

Retourneert een PathInfo-object dat de locatie vertegenwoordigt. Deze cmdlet genereert standaard geen uitvoer.

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

-Path

Geef het pad op van een nieuwe werklocatie. Als er geen pad is opgegeven, wordt Set-Location standaard ingesteld op de basismap van de huidige gebruiker. Wanneer jokertekens worden gebruikt, kiest de cmdlet het eerste pad dat overeenkomt met het jokertekenpatroon.

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

-StackName

Hiermee geeft u de naam van de locatiestack op die door deze cmdlet de huidige locatiestack wordt gemaakt. Voer de naam van een locatiestack in. Als u de niet-benoemde standaardlocatiestack wilt aangeven, typt u $null of een lege tekenreeks ("").

De *-Location cmdlets handelen op de huidige stack, tenzij u de parameter StackName gebruikt om een andere stack op te geven.

Type:String
Position:Named
Default value:None
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_Transactions voor 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 met een pad, maar niet een letterlijk pad, doorsluisen naar deze cmdlet.

Uitvoerwaarden

None, System.Management.Automation.PathInfo, System.Management.Automation.PathInfoStack

Met deze cmdlet wordt geen uitvoer gegenereerd, tenzij u de parameter PassThru opgeeft. Met PassThru- met Pad of LiteralPath wordt een PathInfo--object gegenereerd dat de nieuwe locatie vertegenwoordigt. Met PassThru- met StackName wordt een PathInfoStack--object gegenereerd dat de nieuwe stackcontext vertegenwoordigt.

Notities

  • De cmdlet Set-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.

    Een stack is een lijst waarin alleen het laatst toegevoegde item kan worden geopend. 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. 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 *-Location 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 Get-Location.

    • Als u een nieuwe locatiestack wilt maken, gebruikt u de parameter StackName van 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 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 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 Set-Location met een waarde van $null of een lege tekenreeks ("").