Push-Location
Aggiunge la posizione corrente all'inizio di uno stack di posizioni.
Sintassi
Path (Impostazione predefinita)
Push-Location
[[-Path] <String>]
[-PassThru]
[-StackName <String>]
[-UseTransaction]
[<CommonParameters>]
LiteralPath
Push-Location
[-LiteralPath <String>]
[-PassThru]
[-StackName <String>]
[-UseTransaction]
[<CommonParameters>]
Descrizione
Il Push-Location cmdlet aggiunge ("push") la posizione corrente in uno stack di posizioni. Se si specifica un percorso, Push-Location inserisce la posizione corrente in una pila di posizioni e quindi modifica la posizione corrente nella posizione specificata dal percorso. È possibile utilizzare il Pop-Location cmdlet per ottenere le posizioni dallo stack di posizioni.
Per impostazione predefinita, il Push-Location cmdlet inserisce la posizione corrente nello stack di posizioni corrente, ma è possibile utilizzare il parametro StackName per specificare uno stack di posizioni alternativo. Se lo stack non esiste, Push-Location crea.
Per ulteriori informazioni sulle pile di posizioni, vedere le note.
Esempio
Esempio 1
In questo esempio viene eseguito il push della posizione corrente nello stack di posizioni predefinito, quindi la posizione viene modificata 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à PowerShell (PSDrive).
Esempio 3
Questo comando inserisce la posizione corrente nello stack predefinito. Non cambia la posizione.
PS C:\> Push-Location
Esempio 4 - Creare e utilizzare uno stack denominato
Questi comandi illustrano come creare e utilizzare uno stack di percorsi denominati.
PS C:\> Push-Location ~ -StackName Stack2
PS C:\Users\User01> Pop-Location -StackName Stack2
PS C:\>
Il primo comando inserisce la posizione corrente in un nuovo stack denominato Stack2, quindi modifica la posizione corrente nella directory home, che è rappresentata nel comando dal simbolo della tilde (~) (uguale a $env:USERPROFILE o $HOME).
Se Stack2 non esiste già nella sessione, Push-Location crearlo. Il secondo comando usa il Pop-Location cmdlet per estrarre la posizione originale (PS C:\>) dallo stack Stack2.
Senza il parametro StackName, Pop-Location estrarrebbe la posizione dallo stack predefinito senza nome.
Per altre informazioni sugli stack di posizioni, vedere la Notes.
Parametri
-LiteralPath
Specifica il percorso della nuova posizione. A differenza del parametro Path, il valore del parametro LiteralPath viene usato esattamente come viene digitato. Nessun carattere viene interpretato come metacaratteri. Se il percorso include caratteri di escape, racchiudilo tra virgolette singole. Le virgolette singole indicano a Windows PowerShell di non interpretare alcun carattere come sequenze di escape.
Proprietà dei parametri
| Tipo: | String |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
| Alias: | PSPath |
Set di parametri
LiteralPath
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | True |
| Valore dagli argomenti rimanenti: | False |
-PassThru
Passa un oggetto che rappresenta la posizione alla pipeline. Per impostazione predefinita, questo cmdlet non genera alcun output.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | False |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-Path
Modifica la posizione nella posizione specificata da questo percorso dopo aver aggiunto (inserito) la posizione corrente all'inizio dello stack. Immettere un percorso per qualsiasi posizione il cui provider supporta questo cmdlet. Sono consentiti i metacaratteri. Il nome del parametro è facoltativo.
Proprietà dei parametri
| Tipo: | String |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | True |
| DontShow: | False |
Set di parametri
Path
| Posizione: | 1 |
| Obbligatorio: | False |
| Valore dalla pipeline: | True |
| Valore dalla pipeline in base al nome della proprietà: | True |
| Valore dagli argomenti rimanenti: | False |
-StackName
Specifica lo stack di posizioni a cui viene aggiunta la posizione corrente. Immettere un nome dello stack di percorsi.
Se lo stack non esiste, Push-Location crea.
Senza questo parametro, Push-Location aggiunge la posizione allo stack di posizioni corrente. Per impostazione predefinita, lo stack di percorsi corrente è lo stack di percorsi predefinito senza nome creato da PowerShell.
Per impostare una pila di percorsi come quella corrente, usare il parametro StackName del Set-Location cmdlet. Per altre informazioni sugli stack di posizioni, vedere la Notes.
Annotazioni
Push-Location Non è possibile aggiungere una posizione allo stack predefinito senza nome, a meno che non si tratti dello stack di posizione corrente.
Proprietà dei parametri
| Tipo: | String |
| Valore predefinito: | Default stack |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | True |
| Valore dagli argomenti rimanenti: | False |
-UseTransaction
Include il comando nella transazione attiva. Questo parametro è valido solo quando è in corso una transazione. Per altre informazioni, vedere about_Transactions.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | False |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
| Alias: | usetx |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
CommonParameters
Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedi about_CommonParameters.
Input
String
È possibile reindirizzare una stringa che contiene un percorso (ma non un percorso letterale) a Push-Location.
Output
None or System.Management.Automation.PathInfo
Quando si utilizza il parametro PassThru, Push-Location viene generato un oggetto System.Management.Automation.PathInfo che rappresenta la posizione. In caso contrario, questo cmdlet non genera alcun output.
Note
Una "pila" è un elenco 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 nell'ordine inverso. PowerShell consente di archiviare i percorsi del provider negli stack di posizioni.
PowerShell crea uno stack di percorsi predefinito senza nome ed è possibile creare più stack di percorsi denominati. Se non si specifica un nome per lo stack, Windows PowerShell utilizza lo stack di posizioni corrente. Per impostazione predefinita, il percorso predefinito senza nome è lo stack di percorsi corrente, ma è possibile usare il cmdlet Set-Location per modificare lo stack di percorsi corrente.
Per gestire gli stack di posizioni, usare i cmdlet Posizione di PowerShell, come indicato di seguito.
- Per aggiungere una posizione a uno stack di percorsi, usare il cmdlet
Push-Location. - Per ottenere una posizione da uno stack di percorsi, usare il cmdlet
Pop-Location. - Per visualizzare i percorsi nello stack di percorsi corrente, usare il parametro Stack del cmdlet
Get-Location.
Per visualizzare i percorsi in uno stack di percorsi denominato, usare il parametro StackName del cmdlet Get-Location.
- Per creare un nuovo stack di posizioni, utilizzare il parametro StackName del
Push-Locationcmdlet. Se si specifica uno stack che non esiste,Push-Locationcrea lo stack. - Per impostare una pila di percorsi come quella corrente, usare il parametro StackName del
Set-Locationcmdlet.
Lo stack di percorsi predefinito senza nome è completamente accessibile solo quando si tratta dello stack di percorsi corrente.
Se si imposta una pila di posizioni denominate come stack di posizioni corrente, non è più possibile utilizzare Push-Location i cmdlet o Pop-Location aggiungere o ottenere elementi dalla pila predefinita o utilizzare Get-Location il comando per visualizzare le posizioni nello stack senza nome. Per impostare lo stack senza nome come stack corrente, utilizzare il Set-Location parametro StackName del cmdlet con un valore di $null o una stringa vuota ("").
È anche possibile fare riferimento a Push-Location dal relativo alias predefinito pushd. Per altre informazioni, vedere about_Aliases.
Il cmdlet Push-Location è progettato per lavorare con i dati esposti da qualsiasi provider. Per elencare i provider disponibili nella sessione, digitare Get-PSProvider. Per altre informazioni, consultare about_Providers.