Freigeben über

Set-Location

Modul:
Microsoft.PowerShell.Management Module

Legt den aktuellen Arbeitsort auf eine angegebene Position fest.

Syntax

Path (Standard) 

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

LiteralPath 

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

Stack 

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

Beschreibung

Das Cmdlet Set-Location legt den Arbeitsort auf einen angegebenen Speicherort fest. Dieser Speicherort kann ein Verzeichnis, ein Unterverzeichnis, ein Registrierungsspeicherort oder ein beliebiger Anbieterpfad sein.

Sie können auch den StackName Parameter verwenden, um einen benannten Speicherortstapel zum aktuellen Positionsstapel zu machen. Weitere Informationen zu Positionsstapeln finden Sie in den Notizen.

Beispiele

Beispiel 1: Festlegen der aktuellen Position

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

PS HKLM:\>

Mit diesem Befehl wird der aktuelle Speicherort auf den Stamm des Laufwerks HKLM: festgelegt.

Beispiel 2: Festlegen der aktuellen Position und Anzeigen dieser Position

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

Path
----
Env:\

PS Env:\>

Mit diesem Befehl wird der aktuelle Speicherort auf den Stamm des Env:-Laufwerks festgelegt. Er verwendet den PassThru-Parameter , um PowerShell anzuweisen, ein PathInfo-Objekt zurückzugeben, das den Env:-Speicherort darstellt.

Beispiel 3: Festlegen des Speicherorts auf Laufwerk C:

PS C:\> Set-Location C:

Mit diesem Befehl wird der aktuelle Speicherort des Laufwerks C: im Dateisystemanbieter festgelegt.

Beispiel 4: Festlegen der aktuellen Position auf einen benannten Stapel

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

Mit diesem Befehl wird der WSManPaths-Speicherortstapel zum aktuellen Speicherortstapel.

Die *-Location Cmdlets verwenden den aktuellen Positionsstapel, es sei denn, ein anderer Positionsstapel wird im Befehl angegeben. Weitere Informationen zu Speicherort-Stacks finden Sie in den Hinweisen.

Parameter

-LiteralPath

Gibt einen Pfad des Speicherorts an. Der Wert des LiteralPath--Parameters wird genau so verwendet, wie er eingegeben wird. Es werden keine Zeichen als Wildcardzeichen interpretiert. Wenn der Pfad Escapezeichen enthält, müssen Sie ihn in einfache Anführungszeichen einschließen. Einfache Anführungszeichen signalisieren PowerShell, dass keine Zeichen als Escapesequenzen interpretiert werden sollen.

Einfache Anführungszeichen weisen Windows PowerShell an, keine Zeichen als Escapesequenzen zu interpretieren.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:PSPath

Parametersätze

LiteralPath
Position:Named
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-PassThru

Gibt ein PathInfo- -Objekt zurück, das die Position darstellt. Standardmäßig generiert dieses Cmdlet keine Ausgabe.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:False
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Path

Geben Sie den Pfad eines neuen Arbeitsspeicherorts an. Wenn kein Pfad angegeben wird, wird standardmäßig Set-Location das Startverzeichnis des aktuellen Benutzers verwendet. Wenn Platzhalter verwendet werden, wählt das Cmdlet den ersten Pfad aus, der dem Platzhaltermuster entspricht.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:True
Nicht anzeigen:False

Parametersätze

Path
Position:0
Obligatorisch:False
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-StackName

Gibt den Namen des Speicherortstapels an, den dieses Cmdlet zum aktuellen Speicherortstapel macht. Geben Sie einen Speicherstapelnamen ein. Um den unbenannten Standardspeicherort-Stack anzugeben, geben Sie oder eine leere Zeichenfolge ("") ein $null .

Die *-Location Cmdlets wirken auf den aktuellen Stapel, es sei denn, Sie verwenden den StackName Parameter, um einen anderen Stapel anzugeben.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

Stack
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-UseTransaction

Enthält den Befehl in der aktiven Transaktion. Dieser Parameter ist nur gültig, wenn eine Transaktion ausgeführt wird. Weitere Informationen finden Sie unter about_Transactions.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:False
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:usetx

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.

Eingaben

String

Sie können eine Zeichenfolge, die einen Pfad, aber keinen wörtlichen Pfad enthält, an dieses Cmdlet weiterleiten.

Ausgaben

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

Dieses Cmdlet generiert keine Ausgabe, es sei denn, Sie geben den PassThru-Parameter an. Wenn Sie PassThru mit Path oder LiteralPath verwenden, wird ein PathInfo-Objekt generiert, das den neuen Speicherort darstellt. Wenn Sie PassThru mit StackName verwenden, wird ein PathInfoStack-Objekt generiert, das den neuen Stack-Kontext darstellt.

Hinweise

  • Das Cmdlet Set-Location ist für die Arbeit mit den Daten konzipiert, die von einem beliebigen Anbieter verfügbar gemacht werden. Geben Sie Get-PSProviderein, um die in Ihrer Sitzung verfügbaren Anbieter auflisten zu können. Weitere Informationen finden Sie unter über_Anbieter.

    Ein Stapel ist eine Last-in-First-Out-Liste, in der nur auf das zuletzt hinzugefügte Element zugegriffen werden kann. Sie fügen einem Stapel Elemente in der Reihenfolge hinzu, in der Sie sie verwenden, und rufen sie dann für die Verwendung in umgekehrter Reihenfolge ab. Mit PowerShell können Sie Provider-Standorte in Positionsstapeln speichern. PowerShell erstellt einen nicht benannten Standardspeicherortstapel. Sie können mehrere benannte Speicherortstapel erstellen. Wenn Sie keinen Stapelnamen angeben, verwendet PowerShell den aktuellen Speicherortstapel. Standardmäßig ist der unbenannte Standardort der aktuelle Ortsstapel, aber Sie können die Set-Location Cmdlet, um den aktuellen Speicherortstapel zu ändern.

  • Verwenden Sie zum Verwalten von Positionsstapeln die *-Location Cmdlets wie folgt:

    • Um einen Ort zu einem Ortsstapel hinzuzufügen, verwenden Sie die Push-Location cmdlet.

    • Um einen Ort aus einem Ortsstapel zu erhalten, verwenden Sie die Pop-Location cmdlet.

    • Um die Orte im aktuellen Ortsstapel anzuzeigen, verwenden Sie die Stapel Parameter des Get-Location cmdlet. Um die Speicherorte in einem benannten Positionsstapel anzuzeigen, verwenden Sie den StackName Parameter von Get-Location.

    • Verwenden Sie zum Erstellen eines neuen Speicherortstapels den StackName Parameter von Push-Location. Wenn Sie einen nicht vorhandenen Stapel angeben, erstellt Push-Location den Stapel.

    • Um einen Positionsstapel zum aktuellen Positionsstapel zu machen, verwenden Sie den StackName Parameter von Set-Location.

      Auf den unbenannten Standardspeicherstapel kann nur vollständig zugegriffen werden, wenn es sich dabei um den aktuellen Speicherstapel handelt. Wenn Sie einen benannten Speicherortstapel zum aktuellen Speicherortstapel machen, können Sie die Push-Location Cmdlets zum Hinzufügen oder Abrufen von Elementen aus dem Standardstapel nicht mehr verwenden Pop-Location oder zum Anzeigen der Speicherorte im unbenannten Stapel verwendenGet-Location. Um den unbenannten Stack zum aktuellen Stack zu machen, verwenden Sie den StackName-Parameter von Set-Location mit dem Wert oder $null einer leeren Zeichenfolge ("").