Udostępnij za pośrednictwem

Push-Location

  • Odwołanie
Moduł:
Microsoft.PowerShell.Management

Dodaje bieżącą lokalizację na początku stosu lokalizacji.

Składnia

Push-Location
    [[-Path] <String>]
    [-PassThru]
    [-StackName <String>]
    [<CommonParameters>]
Push-Location
    [-LiteralPath <String>]
    [-PassThru]
    [-StackName <String>]
    [<CommonParameters>]

Opis

Polecenie cmdlet Push-Location dodaje bieżącą lokalizację ("wypycha") do stosu lokalizacji. Jeśli określisz ścieżkę, Push-Location wypchnie bieżącą lokalizację do stosu lokalizacji, a następnie zmieni bieżącą lokalizację na lokalizację określoną przez ścieżkę. Aby pobrać lokalizacje ze stosu lokalizacji, możesz użyć polecenia cmdlet Pop-Location.

Domyślnie polecenie cmdlet Push-Location wypycha bieżącą lokalizację do bieżącego stosu lokalizacji, ale można użyć parametru StackName, aby określić alternatywny stos lokalizacji. Jeśli stos nie istnieje, Push-Location go utworzy.

Aby uzyskać więcej informacji na temat stosów lokalizacji, zobacz Notes.

Przykłady

Przykład 1

W tym przykładzie bieżąca lokalizacja jest wypychana do domyślnego stosu lokalizacji, a następnie zmienia lokalizację na C:\Windows.

PS C:\> Push-Location C:\Windows

Przykład 2

W tym przykładzie bieżąca lokalizacja jest wypychana do stosu RegFunction i zmienia bieżącą lokalizację na lokalizację HKLM:\Software\Policies.

PS C:\> Push-Location HKLM:\Software\Policies -StackName RegFunction

Polecenia cmdlet Lokalizacja można używać na dowolnym dysku programu PowerShell (PSDrive).

Przykład 3

To polecenie wypycha bieżącą lokalizację do domyślnego stosu. Nie zmienia lokalizacji.

PS C:\> Push-Location

Przykład 4 — tworzenie i używanie nazwanego stosu

Te polecenia pokazują, jak utworzyć i użyć nazwanego stosu lokalizacji.

PS C:\> Push-Location ~ -StackName Stack2
PS C:\Users\User01> Pop-Location -StackName Stack2
PS C:\>

Pierwsze polecenie wypycha bieżącą lokalizację do nowego stosu o nazwie Stack2, a następnie zmienia bieżącą lokalizację do katalogu macierzystego reprezentowanego w poleceniu za pomocą symbolu tyldy (~), który w przypadku użycia na dyskach dostawcy systemu plików jest odpowiednikiem $HOME.

Jeśli usługa Stack2 nie istnieje jeszcze w sesji, Push-Location go utworzy. Drugie polecenie używa polecenia cmdlet Pop-Location, aby wyskakować oryginalną lokalizację (C:\) ze stosu Stack2. Bez parametru StackNamePop-Location umieścić lokalizację z nienazwanego stosu domyślnego.

Aby uzyskać więcej informacji na temat stosów lokalizacji, zobacz Notes.

Parametry

-LiteralPath

Określa ścieżkę do nowej lokalizacji. W przeciwieństwie do parametru Path wartość parametru LiteralPath jest używana dokładnie tak, jak jest typowana. Znaki nie są interpretowane jako symbole wieloznaczne. Jeśli ścieżka zawiera znaki ucieczki, należy ująć ją w pojedynczy cudzysłów. Pojedyncze znaki cudzysłowu informują program PowerShell, aby nie interpretował żadnych znaków jako sekwencji ucieczki.

Typ:String
Aliasy:PSPath, LP
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-PassThru

Przekazuje obiekt reprezentujący lokalizację do potoku. Domyślnie to polecenie cmdlet nie generuje żadnych danych wyjściowych.

Typ:SwitchParameter
Position:Named
Domyślna wartość:False
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Path

Zmienia lokalizację na lokalizację określoną przez tę ścieżkę po dodaniu (wypchnięciu) bieżącej lokalizacji na początku stosu. Wprowadź ścieżkę do dowolnej lokalizacji, której dostawca obsługuje to polecenie cmdlet. Dozwolone są symbole wieloznaczne. Nazwa parametru jest opcjonalna.

Typ:String
Position:1
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:True

-StackName

Określa stos lokalizacji, do którego jest dodawana bieżąca lokalizacja. Wprowadź nazwę stosu lokalizacji. Jeśli stos nie istnieje, Push-Location go utworzy.

Bez tego parametru Push-Location dodaje lokalizację do bieżącego stosu lokalizacji. Domyślnie bieżący stos lokalizacji to nienazwany domyślny stos lokalizacji tworzony przez program PowerShell. Aby utworzyć stos lokalizacji w bieżącym stosie lokalizacji, użyj parametru StackName polecenia cmdlet Set-Location. Aby uzyskać więcej informacji na temat stosów lokalizacji, zobacz Notes.

Nuta

Push-Location nie można dodać lokalizacji do nienazwanego domyślnego stosu, chyba że jest to bieżący stos lokalizacji.

Typ:String
Position:Named
Domyślna wartość:Default stack
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

Dane wejściowe

String

Możesz potokować ciąg zawierający ścieżkę (ale nie ścieżkę literału) do tego polecenia cmdlet.

Dane wyjściowe

None

Domyślnie to polecenie cmdlet nie zwraca żadnych danych wyjściowych.

PathInfo

Jeśli używasz parametru PassThru, to polecenie cmdlet zwraca obiekt PathInfo reprezentujący bieżącą ścieżkę po operacji polecenia cmdlet.

Uwagi

Program PowerShell zawiera następujące aliasy dla Push-Location:

  • Wszystkie platformy:
    • pushd

Program PowerShell obsługuje wiele obszarów runspace na proces. Każdy obszar uruchamiania ma własną bieżącego katalogu. Nie jest to samo, co [System.Environment]::CurrentDirectory. Takie zachowanie może być problemem podczas wywoływania interfejsów API platformy .NET lub uruchamiania aplikacji natywnych bez podawania jawnych ścieżek katalogu.

Nawet jeśli polecenia cmdlet lokalizacji ustawiły bieżący katalog dla całego procesu, nie można od niego zależeć, ponieważ inna przestrzeń uruchomieniowa może ją zmienić w dowolnym momencie. Polecenia cmdlet lokalizacji powinny służyć do wykonywania operacji opartych na ścieżkach przy użyciu bieżącego katalogu roboczego specyficznego dla bieżącego obszaru uruchamiania.

Stos jest ostatnią listą, w której dostępny jest tylko ostatnio dodany element. Elementy są dodawane do stosu w kolejności, w której są używane, a następnie pobierane do użycia w odwrotnej kolejności. Program PowerShell umożliwia przechowywanie lokalizacji dostawców w stosach lokalizacji.

Program PowerShell tworzy nienazwany domyślny stos lokalizacji i można utworzyć wiele nazwanych stosów lokalizacji. Jeśli nie określisz nazwy stosu, program PowerShell używa bieżącego stosu lokalizacji. Domyślnie nienazwana lokalizacja domyślna to bieżący stos lokalizacji, ale możesz użyć polecenia cmdlet Set-Location, aby zmienić bieżący stos lokalizacji.

Aby zarządzać stosami lokalizacji, użyj poleceń cmdlet lokalizacji programu PowerShell w następujący sposób.

  • Aby dodać lokalizację do stosu lokalizacji, użyj polecenia cmdlet Push-Location.

  • Aby uzyskać lokalizację z stosu lokalizacji, użyj polecenia cmdlet Pop-Location.

  • Aby wyświetlić lokalizacje w bieżącym stosie lokalizacji, użyj parametru Stack polecenia cmdlet Get-Location.

  • Aby wyświetlić lokalizacje w nazwanym stosie lokalizacji, użyj parametru StackName polecenia cmdlet Get-Location.

  • Aby utworzyć nowy stos lokalizacji, użyj parametru StackName polecenia cmdlet Push-Location. Jeśli określisz stos, który nie istnieje, Push-Location utworzy stos.

  • Aby utworzyć stos lokalizacji w bieżącym stosie lokalizacji, użyj parametru StackName polecenia cmdlet Set-Location.

Nienazwany domyślny stos lokalizacji jest w pełni dostępny tylko wtedy, gdy jest to bieżący stos lokalizacji. Jeśli ustawisz nazwany stos lokalizacji w bieżącym stosie lokalizacji, nie możesz już używać poleceń cmdlet Push-Location lub Pop-Location do dodawania lub pobierania elementów ze stosu domyślnego lub używania polecenia cmdlet Get-Location do wyświetlania lokalizacji w nienazwanym stosie. Aby ustawić bieżący stos bez nazwy, użyj parametru StackName polecenia cmdlet Set-Location z wartością $null lub pustym ciągiem ("").

Możesz również odwołać się do Push-Location za pomocą wbudowanego aliasu pushd. Aby uzyskać więcej informacji, zobacz about_Aliases.

Polecenie cmdlet Push-Location jest przeznaczone do pracy z danymi udostępnianymi przez dowolnego dostawcę. Aby wyświetlić listę dostawców dostępnych w sesji, wpisz Get-PSProvider. Aby uzyskać więcej informacji, zobacz about_Providers.