Udostępnij za pośrednictwem

Set-Location

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

Ustawia bieżącą lokalizację roboczą na określoną lokalizację.

Składnia

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

Opis

Polecenie Set-Location cmdlet ustawia lokalizację roboczą na określoną lokalizację. Ta lokalizacja może być katalogiem, podkatalogem, lokalizacją rejestru lub dowolną ścieżką dostawcy.

Możesz również użyć parametru StackName , aby utworzyć nazwany stos lokalizacji jako bieżący stos lokalizacji. Aby uzyskać więcej informacji na temat stosów lokalizacji, zobacz Uwagi.

Przykłady

Przykład 1: Ustawianie bieżącej lokalizacji

PS C:\> Set-Location -Path "HKLM:"

PS HKLM:\>

To polecenie ustawia bieżącą lokalizację na katalog główny dysku HKLM: .

Przykład 2: Ustawianie bieżącej lokalizacji i wyświetlanie tej lokalizacji

PS C:\> Set-Location -Path "Env:" -PassThru

Path
----
Env:\

PS Env:\>

To polecenie ustawia bieżącą lokalizację na katalog główny dysku Env: . Używa parametru PassThru , aby skierować program PowerShell do zwrócenia obiektu PathInfo reprezentującego lokalizację Env: .

Przykład 3: Ustawianie lokalizacji na dysku C:

PS C:\> Set-Location C:

To polecenie ustawia bieżącą lokalizację C: dysku w dostawcy systemu plików.

Przykład 4. Ustawianie bieżącej lokalizacji na nazwany stos

PS C:\> Set-Location -StackName "WSManPaths"

To polecenie sprawia, że lokalizacja WSManPaths stos bieżącej lokalizacji.

Polecenia *-Location cmdlet używają bieżącego stosu lokalizacji, chyba że w poleceniu określono inny stos lokalizacji. Aby uzyskać informacje o stosach lokalizacji, zobacz Uwagi.

Parametry

-LiteralPath

Określa ścieżkę lokalizacji. Wartość parametru LiteralPath jest używana dokładnie tak, jak jest typowana. Znaki wieloznaczne nie są interpretowane jako znaki wieloznaczne. Jeśli ścieżka zawiera znaki ucieczki, należy ująć ją w znaki pojedynczego cudzysłowu. Znaki pojedynczego cudzysłowu informują program PowerShell, aby nie interpretował żadnych znaków jako sekwencji ucieczki.

Pojedyncze znaki cudzysłowu informują, Windows PowerShell nie interpretować żadnych znaków jako sekwencji ucieczki.

Type:String
Aliases:PSPath
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-PassThru

Zwraca obiekt PathInfo , który reprezentuje lokalizację. Domyślnie to polecenie cmdlet nie generuje żadnego wyniku.

Type:SwitchParameter
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Path

Określ ścieżkę nowej lokalizacji roboczej. Jeśli nie zostanie podana żadna ścieżka, Set-Location zostanie domyślnie ustawiona wartość domyślna katalogu macierzystego bieżącego użytkownika. Gdy są używane symbole wieloznaczne, polecenie cmdlet wybiera pierwszą ścieżkę zgodną ze wzorcem z symbolami wieloznacznymi.

Type:String
Position:0
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:True

-StackName

Określa nazwę stosu lokalizacji, którą to polecenie cmdlet tworzy bieżący stos lokalizacji. Wprowadź nazwę stosu lokalizacji. Aby wskazać nienazwany domyślny stos lokalizacji, wpisz $null lub pusty ciąg ("").

Polecenia *-Location cmdlet działają na bieżącym stosie, chyba że używasz parametru StackName do określenia innego stosu.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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.

Type:SwitchParameter
Aliases:usetx
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Dane wejściowe

String

Do tego polecenia cmdlet można przekazać potok, który zawiera ścieżkę, ale nie ścieżkę literału.

Dane wyjściowe

None, System.Management.Automation.PathInfo, System.Management.Automation.PathInfoStack

To polecenie cmdlet nie generuje żadnych danych wyjściowych, chyba że określisz parametr PassThru . Użycie metody PassThru ze ścieżką lub parametrem LiteralPath generuje obiekt PathInfo , który reprezentuje nową lokalizację. Użycie metody PassThru z parametrem StackName generuje obiekt PathInfoStack reprezentujący nowy kontekst stosu.

Uwagi

  • Polecenie Set-Location cmdlet 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.

    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 ich użycia, 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 stos lokalizacji domyślnej. 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 *-Location poleceń cmdlet w następujący sposób:

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

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

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

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