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:.
|
Obbligatorio? |
false |
|
Posizione? |
named |
|
Valore predefinito |
|
|
Accettare input da pipeline? |
true (ByPropertyName) |
|
Accettare caratteri jolly? |
false |
-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.
|
Obbligatorio? |
false |
|
Posizione? |
named |
|
Valore predefinito |
|
|
Accettare input da pipeline? |
true (ByPropertyName) |
|
Accettare caratteri jolly? |
false |
-Stack
Visualizza i percorsi nello stack di percorsi predefinito.
Per aggiungere percorsi allo stack predefinito, utilizzare il cmdlet Push-Location.
|
Obbligatorio? |
false |
|
Posizione? |
named |
|
Valore predefinito |
|
|
Accettare input da pipeline? |
false |
|
Accettare caratteri jolly? |
false |
-StackName <string[]>
Visualizza i percorsi nello stack di percorsi specificato.
Per creare stack di percorsi, utilizzare il cmdlet Push-Location.
|
Obbligatorio? |
false |
|
Posizione? |
named |
|
Valore predefinito |
|
|
Accettare input da pipeline? |
true (ByPropertyName) |
|
Accettare caratteri jolly? |
false |
-UseTransaction
Include il comando nella transazione attiva. Questo parametro è valido solo quando è in corso una transazione. Per ulteriori informazioni, vedere about_Transactions.
|
Obbligatorio? |
false |
|
Posizione? |
named |
|
Valore predefinito |
|
|
Accettare input da pipeline? |
false |
|
Accettare caratteri jolly? |
false |
<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.
|
Input |
Nessuno Non è possibile reindirizzare l'input a questo cmdlet. |
|
Output |
Oggetti PathInfo o StackInfo Se si utilizzano i parametri Stack o StackName, Get-Location restituisce un oggetto StackInfo. In caso contrario, restituisce un oggetto PathInfo. |
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