Push-Location
Aggiunge il percorso corrente all'inizio di uno stack di percorsi.
Sintassi
Push-Location
[[-Path] <String>]
[-PassThru]
[-StackName <String>]
[-UseTransaction]
[<CommonParameters>]
Push-Location
[-LiteralPath <String>]
[-PassThru]
[-StackName <String>]
[-UseTransaction]
[<CommonParameters>]
Descrizione
Il Push-Location
cmdlet aggiunge ("push") il percorso corrente in uno stack di posizioni. Se si specifica un percorso, Push-Location
eseguire il push della posizione corrente in uno stack di posizioni e quindi modificare la posizione corrente nella posizione specificata dal percorso. È possibile usare il Pop-Location
cmdlet per ottenere posizioni dallo stack di posizioni.
Per impostazione predefinita, il cmdlet esegue il Push-Location
push della posizione corrente nello stack di posizioni corrente, ma è possibile usare il parametro StackName per specificare uno stack di posizioni alternativo. Se lo stack non esiste, Push-Location
lo crea.
Per altre informazioni sugli stack di percorsi, vedere le note.
Esempio
Esempio 1
In questo esempio viene eseguito il push della posizione corrente nello stack di posizioni predefinito e quindi viene modificato il percorso in C:\Windows
.
PS C:\> Push-Location C:\Windows
Esempio 2
In questo esempio viene eseguito il push della posizione corrente nello stack RegFunction e viene modificata la posizione corrente nella HKLM:\Software\Policies
posizione.
PS C:\> Push-Location HKLM:\Software\Policies -StackName RegFunction
È possibile usare i cmdlet Location in qualsiasi unità di PowerShell (PSDrive).
Esempio 3
Questo comando effettua il push del percorso corrente nello stack predefinito. Non modifica il percorso.
PS C:\> Push-Location
Esempio 4 : Create e usare uno stack denominato
Questi comandi illustrano come creare e usare uno stack di percorsi con nome.
PS C:\> Push-Location ~ -StackName Stack2
PS C:\Users\User01> Pop-Location -StackName Stack2
PS C:\>
Il primo comando esegue il push della posizione corrente in un nuovo stack denominato Stack2 e quindi modifica la posizione corrente nella home directory, rappresentata nel comando dal simbolo tilde (~) (uguale $env:USERPROFILE
a o $HOME
).
Se Stack2 non esiste già nella sessione, Push-Location
lo crea. Il secondo comando usa il Pop-Location
cmdlet per visualizzare il percorso originale (PS C:\>) dallo stack Stack2.
Senza il parametro StackName, Pop-Location
verrà visualizzata la posizione dallo stack predefinito senza nome.
Per altre informazioni sugli stack di località, vedere le note.
Parametri
-LiteralPath
Specifica il percorso della nuova posizione. A differenza del parametro Path, il valore del parametro LiteralPath viene usato esattamente com'è digitato. Nessun carattere viene interpretato come carattere jolly. Se il percorso include caratteri di escape, racchiuderlo tra virgolette singole. Le virgolette singole indicano a Windows PowerShell di non interpretare i caratteri come sequenze di escape.
Type: | String |
Aliases: | PSPath |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-PassThru
Passa un oggetto che rappresenta il percorso alla pipeline. Per impostazione predefinita, il cmdlet non genera alcun output.
Type: | SwitchParameter |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Path
Passa alla posizione specificata da questo percorso dopo aver aggiunto (effettuato il push) il percorso corrente all'inizio dello stack. Immettere un percorso di un qualsiasi provider che supporta questo cmdlet. I caratteri jolly sono consentiti. Il nome del parametro è facoltativo.
Type: | String |
Position: | 1 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | True |
-StackName
Specifica lo stack di percorsi a cui viene aggiunto il percorso corrente. Immettere un nome per lo stack di percorsi.
Se lo stack non esiste, Push-Location
lo crea.
Senza questo parametro, Push-Location
aggiunge la posizione allo stack di posizioni corrente. Per impostazione predefinita, lo stack di posizioni corrente è lo stack di percorsi predefinito non predefinito creato da PowerShell.
Per creare uno stack di posizioni lo stack di posizioni corrente, usare il parametro StackName del Set-Location
cmdlet. Per altre informazioni sugli stack di località, vedere le note.
Nota
Push-Location
non può aggiungere una posizione allo stack predefinito senza nome, a meno che non sia lo stack di posizioni corrente.
Type: | String |
Position: | Named |
Default value: | Default stack |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-UseTransaction
Include il comando nella transazione attiva. Questo parametro è valido solo quando è in corso una transazione. Per altre informazioni, vedere about_Transactions.
Type: | SwitchParameter |
Aliases: | usetx |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Input
È possibile inviare una pipe a una stringa che contiene un percorso (ma non un percorso letterale) su Push-Location
.
Output
None or System.Management.Automation.PathInfo
Quando si usa il parametro PassThru, Push-Location
genera un oggetto System.Management.Automation.PathInfo che rappresenta la posizione. In caso contrario, il cmdlet non genera alcun output.
Note
Uno "stack" è un elenco di tipo LIFO (Last-In, First-Out) in cui è accessibile solo l'elemento aggiunto più di recente. È possibile aggiungere elementi a uno stack nell'ordine in cui vengono usati e quindi recuperarli per l'uso in ordine inverso. PowerShell consente di archiviare i percorsi del provider negli stack di località.
PowerShell crea uno stack di percorsi predefinito senza nome ed è possibile creare più stack di posizioni denominate. Se non si specifica un nome di stack, Windows PowerShell usa lo stack di percorsi corrente. Per impostazione predefinita, la posizione predefinita non denominata è lo stack di posizioni corrente, ma è possibile usare il Set-Location
cmdlet per modificare lo stack di posizioni corrente.
Per gestire gli stack di posizioni, usare i cmdlet Location di PowerShell, come indicato di seguito.
- Per aggiungere una posizione a uno stack di posizioni, usare il
Push-Location
cmdlet. - Per ottenere una posizione da uno stack di posizioni, usare il
Pop-Location
cmdlet. - Per visualizzare le posizioni nello stack di posizioni corrente, usare il parametro Stack del
Get-Location
cmdlet.
Per visualizzare i percorsi in uno stack di posizioni denominato, usare il parametro StackName del Get-Location
cmdlet.
- Per creare un nuovo stack di posizioni, usare il parametro StackName del
Push-Location
cmdlet. Se si specifica uno stack che non esiste,Push-Location
crea lo stack. - Per creare uno stack di posizioni lo stack di posizioni corrente, usare il parametro StackName del
Set-Location
cmdlet.
Lo stack di percorsi predefinito senza nome è pienamente accessibile solo quando è lo stack di percorsi corrente.
Se si crea uno stack di posizioni denominato nello stack di posizioni corrente, non è più possibile usare Push-Location
o Pop-Location
ottenere elementi dallo stack predefinito o usare Get-Location
il comando per visualizzare le posizioni nello stack non denominato. Per rendere lo stack senza nome lo stack corrente, usare il parametro StackName del Set-Location
cmdlet con un valore di $null o una stringa vuota ("").
È anche possibile fare riferimento al Push-Location
relativo alias predefinito, pushd
. Per altre informazioni, vedere about_Aliases.
Il Push-Location
cmdlet è progettato per usare i dati esposti da qualsiasi provider. Per elencare i provider disponibili nella sessione, digitare Get-PSProvider
. Per altre informazioni, vedere about_Providers.