Push-Location
Fügt den aktuellen Speicherort an oberster Stelle in der Liste von Speicherorten (einem "Stapel") hinzu.
Syntax
Push-Location [[-LiteralPath] <string>] [-PassThru] [-StackName <string>] [-UseTransaction] [<CommonParameters>]
Push-Location [[-Path] <string>] [-PassThru] [-StackName <string>] [-UseTransaction] [<CommonParameters>]
Beschreibung
Das Cmdlet "Push-Location" verschiebt den aktuellen Speicherort an die erste Stelle in einer Liste von Speicherorten, die als "Stapel" bezeichnet wird. Der aktuelle Speicherort kann auf einen Standardstapel oder auf einen von Ihnen erstellten Stapel verschoben werden. Wenn Sie einen Pfad angeben, verschiebt "Push-Location" den aktuellen Speicherort auf den Stapel und ändert dann den aktuellen Speicherort in den vom Pfad angegebenen Speicherort. Sie können keine Speicherorte auf den Stapel verschieben, es sei denn, es handelt sich um den aktuellen Speicherort.
Parameter
-LiteralPath <string>
Gibt den Pfad zum neuen Speicherort an. Im Gegensatz zum Path-Parameter wird der Wert des LiteralPath-Parameters 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? |
false |
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>
Ändert den Speicherort in den von diesem Pfad angegebenen Speicherort, nachdem der aktuelle Speicherort dem Stapel an oberster Position hinzugefügt wurde. Geben Sie einen Pfad zu einem Speicherort ein, dessen Anbieter dieses Cmdlet unterstützt. Platzhalter sind zulässig. Der Parametername ("Path") ist optional.
Erforderlich? |
false |
Position? |
1 |
Standardwert |
|
Pipelineeingaben akzeptieren? |
true (ByValue, ByPropertyName) |
Platzhalterzeichen akzeptieren? |
false |
-StackName <string>
Gibt den Namen eines Stapels an. Der aktuelle Speicherort wird auf diesen Stapel verschoben, und dieser Stapel wird zum aktuellen Stapel. Wenn der Stapel noch nicht vorhanden ist, wird er erstellt.
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 Push-Location übergeben. |
Ausgaben |
Keiner oder System.Management.Automation.PathInfo Wenn Sie den PassThru-Parameter verwenden, generiert Push-Location ein System.Management.Automation.PathInfo-Objekt, das den Speicherort darstellt. Andernfalls wird von diesem Cmdlet keine Ausgabe generiert. |
Hinweise
Sie können auch über den integrierten Alias "pushd" auf Push-Location verweisen. Weitere Informationen finden Sie unter "about_Aliases".
Bei einem "Stapel" handelt es sich um eine "last-in first-out" (LIFO)-Datenstruktur. Dies ist mit einer vertikalen Liste vergleichbar, bei der nur auf das oberste Element zugegriffen werden kann. Sie können Elemente nur oben auf dem Stapel hinzufügen (sie dorthin verschieben), und Sie können Elemente nur oben vom Stapel abrufen. Wenn Sie Elemente weiter unten im Stapel abrufen möchten, müssen Sie alle darüber liegenden Elemente abrufen.
Das Cmdlet "Push-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>push-location C:\Windows
Beschreibung
-----------
Mit diesem Befehl wird der aktuelle Speicherort auf den Standardstapel verschoben und der Speicherort anschließend in "C:\Windows" geändert.
Beispiel 2
C:\PS>push-location HKLM:\Software\Policies -stackname RegFunction
Beschreibung
-----------
Mit diesem Befehl wird der aktuelle Speicherort auf den Stapel "RegFunction" verschoben und der aktuelle Speicherort in den Speicherort "HKLM:\Software\Policies" geändert. Mit diesem Befehl wird veranschaulicht, dass Sie Push-Location mit dem Windows PowerShell-Registrierungsanbieter verwenden können.
Beispiel 3
C:\PS>push-location
Beschreibung
-----------
Mit diesem Befehl wird der aktuelle Speicherort auf den Standardstapel verschoben.
Beispiel 4
C:\PS>push-location ~ -stackname Stack2
Beschreibung
-----------
Mit diesem Befehl wird der aktuelle Speicherort auf einen neuen Stapel mit dem Namen "Stack2" verschoben und anschließend das aktuelle Verzeichnis in das Stammverzeichnis ("%USERPROFILE%") geändert, das im Befehl durch die Tilde (~) bzw. "$home" dargestellt wird. Der Stapel "Stack2" wird dann zum aktuellen Stapel.