Aggiunge il percorso corrente all'inizio di un elenco di percorsi (stack).
Sintassi
Push-Location [[-LiteralPath] <string>] [-PassThru] [-StackName <string>] [-UseTransaction] [<CommonParameters>] Push-Location [[-Path] <string>] [-PassThru] [-StackName <string>] [-UseTransaction] [<CommonParameters>]
Descrizione
Con il cmdlet Push-Location il percorso corrente viene aggiunto (push) all'inizio di un elenco di percorsi, denominato stack. È possibile effettuare il push del percorso corrente in uno stack predefinito o in uno stack creato dall'utente. Se si specifica un percorso, Push-Location aggiunge il percorso corrente allo stack, quindi modifica il percorso corrente nel percorso specificato. Non è possibile aggiungere un percorso allo stack, se non è il percorso corrente.
Parametri
-LiteralPath <string>
Specifica il nuovo percorso. A differenza del parametro Path, il valore del parametro LiteralPath viene utilizzato così come viene digitato. Nessun carattere viene interpretato come carattere jolly. Se il percorso include caratteri di escape, è necessario racchiuderli tra virgolette singole tramite le quali si comunica a Windows PowerShell di non interpretare alcun carattere come sequenza di escape.
|
Obbligatorio? |
false |
|
Posizione? |
1 |
|
Valore predefinito |
|
|
Accettare input da pipeline? |
true (ByPropertyName) |
|
Accettare caratteri jolly? |
false |
-PassThru
Passa un oggetto che rappresenta il percorso alla pipeline. Per impostazione predefinita, il cmdlet non genera alcun output.
|
Obbligatorio? |
false |
|
Posizione? |
named |
|
Valore predefinito |
|
|
Accettare input da pipeline? |
false |
|
Accettare caratteri jolly? |
false |
-Path <string>
Modifica il percorso nel percorso specificato dopo avere aggiunto il percorso corrente in cima allo stack. Immettere un percorso di un qualsiasi provider che supporta questo cmdlet. È consentito l'utilizzo di caratteri jolly. Il nome del parametro ("Path") è facoltativo.
|
Obbligatorio? |
false |
|
Posizione? |
1 |
|
Valore predefinito |
|
|
Accettare input da pipeline? |
true (ByValue, ByPropertyName) |
|
Accettare caratteri jolly? |
false |
-StackName <string>
Specifica il nome di uno stack. Il percorso corrente viene aggiunto a questo stack, il quale diventa lo stack corrente. Se lo stack non esiste, verrà creato automaticamente.
|
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 |
System.String È possibile reindirizzare una stringa che contiene un percorso (ma non un percorso letterale) a Push-Location. |
|
Output |
Nessuno o System.Management.Automation.PathInfo Quando si utilizza il parametro PassThru, Push-Location genera un oggetto System.Management.Automation.PathInfo che rappresenta il percorso. Negli altri casi, il cmdlet non genera alcun output. |
Note
È inoltre possibile fare riferimento a Push-Location tramite il relativo alias predefinito "pushd". Per ulteriori informazioni, vedere about_Aliases.
Uno stack è una struttura di dati LIFO (last-in first-out). È simile a un elenco verticale in cui solo l'elemento superiore è accessibile. È possibile aggiungere (push) elementi solo all'inizio dello stack e recuperare (pop) elementi solo dall'inizio dello stack. Per raggiungere gli elementi inferiori, è necessario recuperare tutti gli elementi che li precedono.
Il cmdlet Push-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>push-location C:\Windows Descrizione ----------- Con questo comando il percorso corrente viene aggiunto allo stack predefinito, quindi viene modificato in C:\Windows.
Esempio 2
C:\PS>push-location HKLM:\Software\Policies -stackname RegFunction Descrizione ----------- Con questo comando il percorso corrente viene aggiunto allo stack RegFunction, quindi viene modificato in HKLM:\Software\Policies. In questo modo, viene illustrato che è possibile utilizzare Push-Location con il provider Registry di Windows PowerShell.
Esempio 3
C:\PS>push-location Descrizione ----------- Con questo comando il percorso corrente viene aggiunto allo stack predefinito.
Esempio 4
C:\PS>push-location ~ -stackname Stack2 Descrizione ----------- Con questo comando il percorso corrente viene aggiunto a un nuovo stack denominato Stack2, quindi viene modificato nella home directory (%USERPROFILE%) che nel comando è rappresentata dal simbolo tilde (~) o $home. Stack2 diventa lo stack corrente.
Vedere anche