Megosztás a következőn keresztül:

Set-Location

Modul:
Microsoft.PowerShell.Management Module

Beállítja az aktuális munkahelyet egy megadott helyre.

Syntax

Path (Alapértelmezett) 

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

LiteralPath 

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

Stack 

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

Description

A Set-Location parancsmag a munka helyét egy megadott helyre állítja be. Ez a hely lehet könyvtár, alkönyvtár, beállításjegyzék-hely vagy bármely szolgáltatói elérési út.

A StackName paraméterrel is létrehozhat egy elnevezett helyet az aktuális hely veremként. A helyveremekkel kapcsolatos további információkért tekintse meg a Jegyzeteket.

Példák

1. példa: Az aktuális hely beállítása

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

PS HKLM:\>

Ez a parancs az aktuális helyet a HKLM: meghajtó gyökerére állítja.

2. példa: Az aktuális hely beállítása és a hely megjelenítése

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

Path
----
Env:\

PS Env:\>

Ez a parancs az aktuális helyet az Env: meghajtó gyökerére állítja. A PassThru paraméterrel utasítja a PowerShellt egy PathInfo objektum visszaadására, amely az Env: helyet jelöli.

3. példa: Hely beállítása a C: meghajtóra

PS C:\> Set-Location C:

Ez a parancs beállítja az aktuális C: meghajtót a Fájlrendszer-szolgáltatóban.

4. példa: Az aktuális hely beállítása névvel ellátott veremre

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

Ezzel a paranccsal a WSManPaths hely halmozza az aktuális hely vermet.

A *-Location parancsmagok az aktuális hely vermet használják, kivéve, ha a parancs egy másik helyvermet ad meg. A helyveremekkel kapcsolatos további információkért tekintse meg a Jegyzeteket.

Paraméterek

-LiteralPath

Megadja a hely elérési útját. A LiteralPath paraméter értéke pontosan a beíráskor lesz használva. A rendszer egyetlen karaktert sem értelmez helyettesítő karakterként. Ha az elérési útvonal escape karaktereket tartalmaz, tedd azt egyes idézőjelek közé. Az egyes idézőjelek azt mondják a PowerShellnek, hogy egyetlen karaktert se értelmezzen escape szekvenciaként.

Az idézőjelek azt jelzik, hogy a Windows PowerShell nem értelmezi a karaktereket menekülési sorozatként.

Paramétertulajdonságok

Típus:String
Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False
Aliasok:PSPath

Paraméterkészletek

LiteralPath
Position:Named
Kötelező:True
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:True
Fennmaradó argumentumokból származó érték:False

-PassThru

Egy PathInfo objektumot ad vissza, amely a helyet jelöli. Ez a parancsmag alapértelmezés szerint nem hoz létre kimenetet.

Paramétertulajdonságok

Típus:SwitchParameter
Alapértelmezett érték:False
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

(All)
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False

-Path

Adja meg egy új munkahely elérési útját. Ha nincs megadva elérési út, Set-Location alapértelmezés szerint az aktuális felhasználó kezdőkönyvtára lesz. Helyettesítő karakterek használata esetén a parancsmag kiválasztja a helyettesítő karakterek mintájának megfelelő első elérési utat.

Paramétertulajdonságok

Típus:String
Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:True
DontShow:False

Paraméterkészletek

Path
Position:0
Kötelező:False
Folyamatból származó érték:True
Folyamatból származó érték tulajdonságnév alapján:True
Fennmaradó argumentumokból származó érték:False

-StackName

Megadja a hely verem nevét, amelyet ez a parancsmag az aktuális hely vermet készít. Adjon meg egy helyveremnevet. A névtelen alapértelmezett hely veremének jelzéséhez írja be a $null vagy egy üres sztringet ("").

A *-Location parancsmagok az aktuális veremen működnek, hacsak nem használja a StackName paramétert egy másik verem megadásához.

Paramétertulajdonságok

Típus:String
Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

Stack
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:True
Fennmaradó argumentumokból származó érték:False

-UseTransaction

Tartalmazza a parancsot az aktív tranzakcióban. Ez a paraméter csak akkor érvényes, ha egy tranzakció folyamatban van. További információ: about_Transactions.

Paramétertulajdonságok

Típus:SwitchParameter
Alapértelmezett érték:False
Támogatja a helyettesítő karaktereket:False
DontShow:False
Aliasok:usetx

Paraméterkészletek

(All)
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False

CommonParameters

Ez a parancsmag a következő gyakori paramétereket támogatja: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction és -WarningVariable. További információért lásd about_CommonParameters.

Bevitelek

String

Ehhez a parancsmaghoz egy elérési utat tartalmazó, de nem literális elérési utat tartalmazó sztringet csövezhet.

Kimenetek

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

Ez a parancsmag csak akkor hoz létre kimenetet, ha megadja a PassThru paramétert. A PassThruPath vagy LiteralPath használatával létrehoz egy PathInfo objektumot, amely az új helyet jelöli. A PassThruStackName használatával létrehoz egy PathInfoStack objektumot, amely az új veremkörnyezetet jelöli.

Jegyzetek

  • A Set-Location parancsmag úgy lett kialakítva, hogy bármely szolgáltató által közzétett adatokkal működjön együtt. A munkamenetben elérhető szolgáltatók listájához írja be a Get-PSProvider. További információért lásd a about_Providerscímű részt.

    A verem egy utolsó előtti lista, amelyben csak a legutóbb hozzáadott elem érhető el. Elemeket ad hozzá egy veremhez a használt sorrendben, majd lekéri őket fordított sorrendben való használatra. A PowerShell lehetővé teszi a szolgáltatói helyek helyvermekben való tárolását. A PowerShell létrehoz egy névtelen alapértelmezett helyvermet. Több elnevezett helyvermet is létrehozhat. Ha nem ad meg veremnevet, a PowerShell az aktuális hely vermet használja. Alapértelmezés szerint a névtelen alapértelmezett hely az aktuális hely verem, de a Set-Location parancsmaggal módosíthatja az aktuális hely vermet.

  • A helyveremek kezeléséhez használja a *-Location parancsmagokat az alábbiak szerint:

    • Ha helyet szeretne hozzáadni egy helyveremhez, használja a Push-Location parancsmagot.

    • Ha helyet szeretne lekérni egy helyveremből, használja a Pop-Location parancsmagot.

    • Az aktuális helyverem helyeinek megjelenítéséhez használja a parancsmag Get-Location paraméterét. A helyek nevesített helyveremben való megjelenítéséhez használja a Get-Location paraméterét.

    • Új helyverem létrehozásához használja a Push-Location paraméterét. Ha nem létező vermet ad meg, Push-Location hozza létre a vermet.

    • A helyverem aktuális helyveremként való létrehozásához használja a Set-Location paraméterét.

      A névtelen alapértelmezett helyverem csak akkor érhető el teljes mértékben, ha az aktuális hely verem. Ha egy elnevezett hely vermet hoz létre az aktuális hely veremként, a továbbiakban nem használhatja Push-Location vagy Pop-Location parancsmagok nem adhatnak hozzá vagy kérhetnek le elemeket az alapértelmezett veremből, vagy a Get-Location használatával nem jeleníthetők meg a névtelen verem helyei. A névtelen verem aktuális veremként való létrehozásához használja a Set-Location paraméterét $null vagy üres sztring ("").