Legt den aktuellen Arbeitsspeicherort auf einen angegebenen Speicherort fest.

Syntax

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

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

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

Beschreibung

Mit dem Cmdlet "Set-Location" wird der Arbeitsspeicherort auf einen angegebenen Speicherort festgelegt. Bei diesem Speicherort kann es sich um ein Verzeichnis, ein Unterverzeichnis, einen Registrierungsspeicherort oder einen anderen Speicherortstapel handeln.

Parameter

-LiteralPath <string>

Gibt einen Pfad zum Speicherort an. Der Wert des LiteralPath-Parameters wird genau so verwendet, wie er eingegeben wurde. Es werden keine Zeichen als Platzhalter interpretiert. Wenn der Pfad Escapezeichen enthält, müssen Sie ihn in einfache Anführungszeichen einschließen. Einfache Anführungszeichen veranlassen Windows PowerShell, Zeichen nicht als Escapesequenzen zu interpretieren.

Erforderlich?

true

Position?

1

Standardwert

Pipelineeingaben akzeptieren?

true (ByPropertyName)

Platzhalterzeichen akzeptieren?

false

-PassThru

Übergibt ein Objekt, das den Speicherort darstellt, an die Pipeline. Standardmäßig wird von diesem Cmdlet keine Ausgabe generiert.

Erforderlich?

false

Position?

named

Standardwert

Pipelineeingaben akzeptieren?

false

Platzhalterzeichen akzeptieren?

false

-Path <string>

Mit diesem Parameter wird der Pfad zu einem neuen Arbeitsspeicherort angegeben.

Erforderlich?

false

Position?

1

Standardwert

Pipelineeingaben akzeptieren?

true (ByValue, ByPropertyName)

Platzhalterzeichen akzeptieren?

false

-StackName <string>

Der Name des Stapels, auf den der Speicherort festgelegt wird.

Erforderlich?

false

Position?

named

Standardwert

Pipelineeingaben akzeptieren?

true (ByPropertyName)

Platzhalterzeichen akzeptieren?

false

-UseTransaction

Schließt den Befehl in die aktive Transaktion ein. Dieser Parameter ist nur gültig, wenn eine Transaktion ausgeführt wird. Weitere Informationen finden Sie unter "about_Transactions".

Erforderlich?

false

Position?

named

Standardwert

Pipelineeingaben akzeptieren?

false

Platzhalterzeichen akzeptieren?

false

<CommonParameters>

Dieses Cmdlet unterstützt die folgenden allgemeinen Parameter: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer und -OutVariable. Weitere Informationen finden Sie unter about_Commonparameters.

Eingaben und Ausgaben

Der Eingabetyp ist der Typ der Objekte, die über die Pipeline an das Cmdlet übergeben werden können. Der Rückgabetyp ist der Typ der Objekte, die das Cmdlet zurückgibt.

Eingaben

System.String

Sie können eine Zeichenfolge, die einen Pfad (jedoch keinen literalen Pfad) enthält, über die Pipeline an Set-Location übergeben.

Ausgaben

Keiner oder System.Management.Automation.PathInfo

Wenn Sie den PassThru-Parameter verwenden, generiert Set-Location ein System.Management.Automation.PathInfo-Objekt, das den Speicherort darstellt. Andernfalls wird von diesem Cmdlet keine Ausgabe generiert.

Hinweise

Das Cmdlet "Set-Location" ist für die Verwendung mit Daten konzipiert, die von beliebigen Anbietern verfügbar gemacht werden. Um die in der Sitzung verfügbaren Anbieter aufzuführen, geben Sie "Get-PSProvider" ein. Weitere Informationen finden Sie unter "about_Providers".

Beispiel 1

C:\PS>set-location HKLM:

Beschreibung
-----------
Dadurch wird der aktuelle Speicherort auf den angegebenen Speicherort festgelegt, in diesem Fall den HKLM-Anbieter.






Beispiel 2

C:\PS>set-location env: -passthru

Path
----
Env:\

Beschreibung
-----------
Dadurch wird der aktuelle Speicherort auf den angegebenen Speicherort festgelegt, in diesem Fall den Umgebungsvariablenanbieter.






Beispiel 3

C:\PS>set-location C:

Beschreibung
-----------
Dadurch wird der aktuelle Speicherort auf den angegebenen Speicherort festgelegt, in diesem Fall Laufwerk "C:" auf dem Dateisystemanbieter.






Siehe auch




Inhaltsverzeichnis