Sdílet prostřednictvím

Set-Location

Modul:
Microsoft.PowerShell.Management Module

Nastaví aktuální pracovní umístění na zadané umístění.

Syntax

Path (Výchozí) 

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

LiteralPath 

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

Stack 

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

Description

Rutina Set-Location nastaví pracovní umístění na zadané umístění. Toto umístění může být adresář, podadresář, umístění registru nebo jakákoli cesta zprostředkovatele.

Můžete také použít parametr StackName k vytvoření pojmenovaného zásobníku umístění jako aktuálního zásobníku umístění. Další informace o zásobníkech umístění najdete v poznámkách.

Příklady

Příklad 1: Nastavení aktuálního umístění

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

PS HKLM:\>

Tento příkaz nastaví aktuální umístění na kořen jednotky HKLM:

Příklad 2: Nastavte aktuální umístění a zobrazte toto umístění.

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

Path
----
Env:\

PS Env:\>

Tento příkaz nastaví aktuální umístění na kořen jednotky Env: . Pomocí parametru PassThru směruje PowerShell k vrácení objektu PathInfo, který představuje umístění Env:

Příklad 3: Nastavení umístění na jednotku C:

PS C:\> Set-Location C:

Tento příkaz nastaví aktuální umístění jednotky C: v zprostředkovateli FileSystem.

Příklad 4: Nastavení aktuálního umístění na pojmenovaný zásobník

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

Tento příkaz vytvoří zásobník umístění WSManPaths jako aktuální zásobník umístění.

Rutiny *-Location používají aktuální zásobník umístění, pokud není v příkazu zadán jiný zásobník umístění. Informace o zásobníkech umístění najdete v poznámkách.

Parametry

-LiteralPath

Určuje cestu k umístění. Hodnota parametru LiteralPath se používá přesně při psaní. Žádné znaky nejsou interpretovány jako zástupné znaky. Pokud cesta obsahuje únikové znaky, uzavřete ji do jednoduchých uvozovek. Jednoduché uvozovky říkají PowerShellu, aby žádné znaky neinterpretoval jako únikové sekvence.

Jednoduché uvozovky říkají prostředí Windows PowerShell, aby nepřekládaly žádné znaky jako řídicí sekvence.

Vlastnosti parametru

Typ:String
Default value:None
Podporuje zástupné znaky:False
DontShow:False
Aliasy:PSPath

Sady parametrů

LiteralPath
Position:Named
Povinné:True
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:True
Hodnota ze zbývajících argumentů:False

-PassThru

Vrátí objekt PathInfo, který představuje umístění. Ve výchozím nastavení tato rutina negeneruje žádný výstup.

Vlastnosti parametru

Typ:SwitchParameter
Default value:False
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-Path

Zadejte cestu k novému pracovnímu umístění. Pokud není k dispozici žádná cesta, Set-Location výchozí nastavení domovského adresáře aktuálního uživatele. Při použití zástupných znaků vybere rutina první cestu, která odpovídá vzoru se zástupným znakem.

Vlastnosti parametru

Typ:String
Default value:None
Podporuje zástupné znaky:True
DontShow:False

Sady parametrů

Path
Position:0
Povinné:False
Hodnota z kanálu:True
Hodnota z kanálu podle názvu vlastnosti:True
Hodnota ze zbývajících argumentů:False

-StackName

Určuje název zásobníku umístění, ze kterého tato rutina vytvoří aktuální zásobník umístění. Zadejte název zásobníku umístění. Pokud chcete označit nepojmenovaný výchozí zásobník umístění, zadejte $null nebo prázdný řetězec ("").

Rutiny *-Location fungují s aktuálním zásobníkem, pokud nepoužíváte parametr StackName k určení jiného zásobníku.

Vlastnosti parametru

Typ:String
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

Stack
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:True
Hodnota ze zbývajících argumentů:False

-UseTransaction

Zahrnuje příkaz v aktivní transakci. Tento parametr je platný pouze v případě, že probíhá transakce. Další informace najdete v tématu about_Transactions.

Vlastnosti parametru

Typ:SwitchParameter
Default value:False
Podporuje zástupné znaky:False
DontShow:False
Aliasy:usetx

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

CommonParameters

Tato rutina podporuje běžné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v about_CommonParameters.

Vstupy

String

Můžete předat řetězec, který obsahuje cestu, ale ne doslovnou cestu, do tohoto příkazu.

Výstupy

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

Tato rutina negeneruje žádný výstup, pokud nezadáte parametr PassThru. Použití PassThru s cestou nebo LiteralPath vygeneruje objekt PathInfo, který představuje nové umístění. Použití PassThru s StackName generuje objekt PathInfoStack představující nový kontext zásobníku.

Poznámky

  • Rutina Set-Location je navržená tak, aby fungovala s daty vystavenými jakýmkoli poskytovatelem. Chcete-li zobrazit seznam poskytovatelů dostupných ve vaší relaci, napište Get-PSProvider. Pro více informací viz about_Providers.

    Zásobník je poslední první seznam, ve kterém lze získat přístup pouze k naposledy přidané položce. Položky přidáte do zásobníku v pořadí, v jakém je používáte, a pak je načtete pro použití v obráceném pořadí. PowerShell umožňuje ukládat umístění zprostředkovatelů do zásobníků umístění. PowerShell vytvoří nepojmenovaný výchozí zásobník umístění. Můžete vytvořit několik pojmenovaných zásobníků umístění. Pokud nezadáte název zásobníku, PowerShell použije aktuální zásobník umístění. Ve výchozím nastavení je nepojmenované výchozí umístění aktuální zásobník umístění, ale ke změně aktuálního zásobníku umístění můžete použít rutinu Set-Location.

  • Ke správě zásobníků umístění použijte rutiny *-Location následujícím způsobem:

    • Pokud chcete přidat umístění do zásobníku umístění, použijte rutinu Push-Location.

    • Pokud chcete získat umístění ze zásobníku umístění, použijte rutinu Pop-Location.

    • Pokud chcete zobrazit umístění v aktuálním zásobníku umístění, použijte parametr Stack rutiny Get-Location. Pokud chcete zobrazit umístění v pojmenovaném zásobníku umístění, použijte parametr StackNameGet-Location.

    • K vytvoření nového zásobníku umístění použijte parametr StackNamePush-Location. Pokud zadáte zásobník, který neexistuje, Push-Location zásobník vytvoří.

    • Pokud chcete vytvořit zásobník umístění jako aktuální zásobník umístění, použijte parametr StackNameSet-Location.

      Výchozí zásobník nenaznačeného umístění je plně přístupný jenom v případech, kdy se jedná o aktuální zásobník umístění. Pokud nastavíte pojmenovaný zásobník umístění jako aktuální zásobník umístění, nemůžete už používat Push-Location ani Pop-Location rutiny přidávat nebo získávat položky z výchozího zásobníku nebo pomocí Get-Location zobrazit umístění v nepojmenovaném zásobníku. Pokud chcete, aby byl zásobník bez názvu aktuální, použijte parametr StackNameSet-Location s hodnotou $null nebo prázdným řetězcem ("").