Get-Location

Ottiene informazioni sulla posizione di lavoro corrente.

Sintassi

Get-Location [-PSDrive <string[]>] [-PSProvider <string[]>] [-UseTransaction] [<CommonParameters>]

Get-Location [-Stack] [-StackName <string[]>] [-UseTransaction] [<CommonParameters>]

Descrizione

Con il cmdlet Get-Location viene ottenuto un oggetto che rappresenta la directory corrente, analogamente al comando pwd (directory di lavoro di stampa).

Quando si passa da un'unità di Windows PowerShell all'altra, Windows PowerShell mantiene il percorso in ogni unità. È possibile utilizzare Get-Location per trovare il percorso in ogni unità.

È anche possibile utilizzare Get-Location per ottenere la directory corrente in fase di esecuzione e utilizzarlo in funzioni e script, ad esempio in una funzione che visualizza la directory corrente nel prompt di Windows PowerShell.

Se si utilizza il cmdlet Push-Location per aggiungere percorsi a un stack di percorsi, è possibile utilizzare il parametro Stack di Get-Location per visualizzare lo stack corrente.

Parametri

-PSDrive <string[]>

Ottiene il percorso corrente nell'unità di Windows PowerShell specificata.

Ad esempio, se ci si trova nell'unità Certificate: è possibile utilizzare questo parametro per trovare il percorso corrente nell'unità C:.

-PSProvider <string[]>

Ottiene il percorso corrente nell'unità supportata dal provider di Windows PowerShell specificato.

Se il provider specificato supporta più unità, Get-Location restituisce il percorso sull'unità a cui si è acceduto più recentemente.

Ad esempio, se ci si trova nell'unità C:, è possibile utilizzare questo parametro per trovare il percorso corrente nelle unità del provider Registry di Windows PowerShell.

-Stack

Visualizza i percorsi nello stack di percorsi predefinito.

Per aggiungere percorsi allo stack predefinito, utilizzare il cmdlet Push-Location.

-StackName <string[]>

Visualizza i percorsi nello stack di percorsi specificato.

Per creare stack di percorsi, utilizzare il cmdlet Push-Location.

-UseTransaction

Include il comando nella transazione attiva. Questo parametro è valido solo quando è in corso una transazione. Per ulteriori informazioni, vedere about_Transactions.

<CommonParameters>

Questo cmdlet supporta i parametri comuni -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer e -OutVariable. Per ulteriori informazioni, vedere about_Commonparameters.

Input e output

Il tipo di input è il tipo degli oggetti che è possibile reindirizzare al cmdlet. Il tipo restituito è il tipo degli oggetti restituiti dal cmdlet.

Note

È possibile archiviare i percorsi in uno stack. Il cmdlet Push-Location aggiunge un percorso in cima allo stack. Il cmdlet Pop-Location ottiene il percorso in cima allo stack.

Le modalità di interazione dei parametri PSProvider, PSDrive, Stack e StackName dipendono dal provider. Alcune combinazioni possono restituire errori, ad esempio nel caso si specifichi sia un'unità sia un provider che non espone tale unità. Se non si specifica alcun parametro, Get-Location restituisce l'oggetto PathInfo per il provider che contiene il percorso di lavoro corrente.

Il cmdlet Get-Location è progettato per l'utilizzo di dati esposti da qualsiasi provider. Per elencare i provider disponibili nella sessione, digitare "Get-PSProvider". Per ulteriori informazioni, vedere about_Providers.

Esempio 1

C:\PS>get-location

Path
----
C:\WINDOWS

Descrizione
-----------
Con questo comando viene visualizzato il percorso nell'unità di Windows PowerShell corrente.

Ad esempio, se ci si trova nella directory di Windows dell'unità C:, viene visualizzato il percorso di tale directory.

Esempio 2

C:\PS>set-location

Descrizione
-----------
Con questi comandi viene illustrato l'utilizzo di Get-Location per visualizzare il percorso corrente in unità di Windows PowerShell diverse.

Nel primo comando viene utilizzato il cmdlet Set-Location per impostare il percorso corrente sulla sottodirectory di Windows dell'unità C:.

    C:\PS> set-location C:\Windows

Nel secondo comando viene utilizzato il cmdlet Set-Location per modificare il percorso sulla chiave del Registro di sistema HKLM:\Software\Microsoft. Quando si passa a un percorso nell'unità HKLM:, Windows PowerShell mantiene il percorso nell'unità C:. 

    PS C:\WINDOWS> set-location HKLM:\Software\Microsoft
    PS HKLM:\Software\Microsoft >

Nel terzo comando viene utilizzato il cmdlet Set-Location per modificare il percorso sulla chiave del Registro di sistema "HKCU:\Control Panel\Input Method".

    PS HKLM:\Software\Microsoft> set-location 'HKCU:\Control Panel\Input Method'
    PS HKCU:\Control Panel\Input Method>

Nel quarto comando viene utilizzato il cmdlet Get-Location per trovare il percorso corrente nell'unità C:. Viene utilizzato il parametro PSDrive per specificare l'unità.

    PS HKCU:\Control Panel\Input Method> get-location -psdrive c
    Path
    ----
    C:\WINDOWS

Nel quinto comando viene utilizzato il cmdlet Set-Location per tornare all'unità C. Anche se nel comando non viene specificata una sottodirectory, Windows PowerShell torna al percorso salvato.

    PS HKCU:\Control Panel\Input Method> set-location C:
    PS C:\WINDOWS>

Nel sesto comando viene utilizzato il cmdlet Get-Location per trovare il percorso corrente nelle unità supportate dal provider Registry di Windows PowerShell. Get-Location restituisce il percorso dell'unità del Registro di sistema a cui si è effettuato più frequentemente l'accesso, HKCU:.

    PS C:\WINDOWS> get-location -psprovider registry
    Path
    ----
    HKCU:\Control Panel\Input Method

Per visualizzare il percorso corrente nell'unità HKLM:, è necessario utilizzare il parametro PSDrive per specificare l'unità. A tale scopo viene utilizzato il settimo comando:

    PS C:\WINDOWS> get-location -psdrive HKLM
    Path
    ----
    HKLM:\Software\Microsoft

Esempio 3

C:\PS>set-location

Descrizione
-----------
Con questi comandi viene illustrato come utilizzare i parametri Stack e StackName di Get-Location per elencare i percorsi negli stack di percorsi predefiniti e alternativi.

Nel primo comando impostato il percorso corrente sulla directory di Windows dell'unità C:.
    
    C:\PS> set-location C:\Windows 

Nel secondo comando viene utilizzato il cmdlet Push-Location per aggiungere il percorso corrente (C:\Windows) allo stack di percorsi e passare alla sottodirectory System32. Poiché non è specificato alcuno stack, il percorso corrente viene aggiunto allo stack predefinito.
    C:\WINDOWS>push-location System32

Il terzo comando inserisce il percorso corrente (C:\Windows\System32) nello stack Stack2 e imposta il percorso sulla sottodirectory WindowsPowerShell.
    
    C:\Windows\System32>push-location WindowsPowerShell -stack Stack2

Nel quarto comando viene utilizzato il cmdlet Get-Location per ottenere i percorsi nello stack di percorsi predefinito.
    
    C:\WINDOWS\system32\WindowsPowerShell>get-location -stack

    Path
    ----
    C:\WINDOWS

Nell'ultimo comando viene utilizzato il parametro StackName di Get-Location per ottenere i percorsi nello stack Stack2.
    
    C:\WINDOWS\system32\WindowsPowerShell>get-location -stackname Stack2

    Path
    ----
    C:\WINDOWS\system32

Esempio 4

C:\PS>function prompt { 'PowerShell: ' + (get-location) + '> '}

PowerShell: C:\WINDOWS>

Descrizione
-----------
In questo esempio viene illustrato come personalizzare il prompt di Windows PowerShell. La funzione che definisce il prompt include un comando Get-Location, eseguito ogni volta che il prompt viene visualizzato nella console.

Il formato del prompt di Windows PowerShell predefinito è definito da una funzione speciale denominata "prompt". È possibile modificare il prompt nella console creando una nuova funzione denominata "prompt".

Per visualizzare la funzione prompt corrente, digitare il seguente comando:
 
    get-content function:prompt

Il comando inizia con la parola chiave "function" seguita dal nome della funzione "prompt". Il corpo della funzione è racchiuso tra parentesi graffe ({}). 

Con questo comando viene definito un nuovo prompt che inizia con la stringa "PowerShell: ". Per aggiungere il percorso corrente, viene utilizzato un comando Get-Location eseguito quando viene chiamata la funzione prompt. Il prompt termina con la stringa">".

Vedere anche

Concetti

about_Providers
Pop-Location
Push-Location
Set-Location