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