Udostępnij za pośrednictwem

Pop-Location

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

Zmienia bieżącą lokalizację na lokalizację ostatnio wypchniętą do stosu.

Składnia

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

Opis

Polecenie Pop-Location cmdlet zmienia bieżącą lokalizację na lokalizację ostatnio wypchniętą do stosu Push-Location przy użyciu polecenia cmdlet . Możesz wybrać lokalizację z domyślnego stosu lub z utworzonego stosu Push-Location za pomocą polecenia .

Przykłady

Przykład 1. Zmiana na najnowszą lokalizację

PS C:\> Pop-Location

To polecenie zmienia lokalizację na lokalizację ostatnio dodaną do bieżącego stosu.

Przykład 2. Zmiana na najnowszą lokalizację w nazwanym stosie

PS C:\> Pop-Location -StackName "Stack2"

To polecenie zmienia lokalizację na lokalizację ostatnio dodaną do stosu lokalizacji Stack2.

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

Przykład 3. Przenoszenie między lokalizacjami dla różnych dostawców

PS C:\> pushd HKLM:\Software\Microsoft\PowerShell
PS HKLM:\Software\Microsoft\PowerShell> pushd Cert:\LocalMachine\TrustedPublisher
PS cert:\LocalMachine\TrustedPublisher> popd
PS HKLM:\Software\Microsoft\PowerShell> popd
PS C:\>

Te polecenia używają Push-Location poleceń cmdlet i Pop-Location do przenoszenia między lokalizacjami obsługiwanymi przez różnych dostawców programu PowerShell. Polecenia używają aliasu pushd i Push-Location aliasu popd dla .Pop-Location

Pierwsze polecenie wypycha bieżącą lokalizację systemu plików do stosu i przenosi się na dysk HKLM obsługiwany przez dostawcę rejestru programu PowerShell.

Drugie polecenie wypycha lokalizację rejestru do stosu i przenosi się do lokalizacji obsługiwanej przez dostawcę certyfikatów programu PowerShell.

Ostatnie dwa polecenia wyskakują te lokalizacje poza stosem. Pierwsze popd polecenie powróci do dysku rejestru, a drugie polecenie powróci do dysku systemu plików.

Parametry

-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ść:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-StackName

Określa stos lokalizacji, z którego jest zwinięte miejsce. Wprowadź nazwę stosu lokalizacji.

Bez tego parametru Pop-Location pojawia się lokalizacja z 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 Set-Location StackName polecenia cmdlet. Aby uzyskać więcej informacji na temat stosów lokalizacji, zobacz Uwagi.

Pop-Location Program nie może umieścić lokalizacji z nienazwanego domyślnego stosu, chyba że jest to bieżący stos lokalizacji.

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

-UseTransaction

Zawiera polecenie w aktywnej transakcji. Ten parametr jest prawidłowy tylko wtedy, gdy transakcja jest w toku. Aby uzyskać więcej informacji, zobacz about_Transactions.

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

Dane wejściowe

None

Nie można potokować obiektów 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 Windows PowerShell zawiera następujące aliasy dla programu Pop-Location:

  • popd

Program PowerShell obsługuje wiele obszarów runspace na proces. Każdy obszar uruchamiania ma własny bieżący katalog. 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ą, pierwszą listą, w której można uzyskać dostęp tylko do ostatnio dodanego elementu. 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ć Set-Location polecenia cmdlet , aby zmienić bieżący stos lokalizacji.

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

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

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

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

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

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

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

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 jako bieżący stos lokalizacji, nie możesz już używać Push-Location poleceń cmdlet lub Pop-Location do dodawania lub pobierania elementów ze stosu domyślnego lub używania Get-Location polecenia cmdlet do wyświetlania lokalizacji w nienazwanym stosie. Aby ustawić bieżący stos bez nazwy, użyj parametru Set-Location StackName polecenia cmdlet z wartością $Null lub pustym ciągiem ("").

Pop-Location jest przeznaczony 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.