Condividi tramite

Set-Location

Modulo:
Microsoft.PowerShell.Management Module

Imposta la posizione di lavoro corrente su una posizione specificata.

Sintassi

Path (Impostazione predefinita) 

Set-Location
    [[-Path] <String>]
    [-PassThru]
    [-UseTransaction]
    [<CommonParameters>]

LiteralPath 

Set-Location
    -LiteralPath <String>
    [-PassThru]
    [-UseTransaction]
    [<CommonParameters>]

Stack 

Set-Location
    [-PassThru]
    [-StackName <String>]
    [-UseTransaction]
    [<CommonParameters>]

Descrizione

Il Set-Location cmdlet imposta il percorso di lavoro su un percorso specificato. Tale percorso può essere una directory, una sottodirectory, un percorso del Registro di sistema o qualsiasi percorso del provider.

È inoltre possibile utilizzare il parametro StackName per impostare uno stack di posizioni denominato come stack di posizioni corrente. Per ulteriori informazioni sulle pile di posizioni, vedere le note.

Esempio

Esempio 1: Impostare la posizione corrente

PS C:\> Set-Location -Path "HKLM:"

PS HKLM:\>

Questo comando imposta la posizione corrente sulla radice dell'unità HKLM:.

Esempio 2: Impostare la posizione corrente e visualizzarla

PS C:\> Set-Location -Path "Env:" -PassThru

Path
----
Env:\

PS Env:\>

Questo comando imposta la posizione corrente sulla radice dell'unità Env:. Usa il parametro PassThru per indicare a PowerShell di restituire un oggetto PathInfo che rappresenta la posizione Env:.

Esempio 3: Impostare la posizione sull'unità C:

PS C:\> Set-Location C:

Questo comando imposta la posizione corrente dell'unità C: nel provider FileSystem.

Esempio 4: Impostare la posizione corrente su uno stack denominato

PS C:\> Set-Location -StackName "WSManPaths"

Questo comando rende lo stack di posizioni WSManPaths lo stack di posizioni corrente.

I *-Location cmdlet usano lo stack di posizioni corrente, a meno che non venga specificato uno stack di posizioni diverso nel comando. Per informazioni sulle pile di posizioni, vedere le note.

Parametri

-LiteralPath

Specifica un percorso della posizione. Il valore del parametro LiteralPath viene utilizzato esattamente come viene digitato. Nessun carattere è interpretato come un carattere jolly. Se il percorso include caratteri di escape, racchiudilo tra virgolette singole. Le virgolette singole indicano a PowerShell di non interpretare alcun carattere come sequenze di escape.

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:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-PassThru

Restituisce un oggetto PathInfo che rappresenta la posizione. 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

Specificare il percorso di una nuova posizione di lavoro. Se non viene specificato alcun percorso, Set-Location il valore predefinito viene utilizzato per la home directory dell'utente corrente. Quando vengono utilizzati i caratteri jolly, il cmdlet sceglie il primo percorso che corrisponde al modello di caratteri jolly.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:True
DontShow:False

Set di parametri

Path
Posizione:0
Obbligatorio:False
Valore dalla pipeline:True
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-StackName

Specifica il nome dello stack di posizioni che questo cmdlet rende lo stack di posizioni corrente. Immettere un nome dello stack di percorsi. Per indicare lo stack di posizioni predefinito senza nome, digitare $null o una stringa vuota ("").

I *-Location cmdlet agiscono sullo stack corrente, a meno che non si utilizzi il parametro StackName per specificare uno stack diverso.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

Stack
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 ulteriori 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 inviare tramite pipe una stringa contenente un percorso, ma non un percorso letterale, a questo cmdlet.

Output

None, System.Management.Automation.PathInfo, System.Management.Automation.PathInfoStack

Questo cmdlet non genera alcun output a meno che non si specifichi il parametro PassThru . L'utilizzo di PassThru con Path o LiteralPath genera un oggetto PathInfo che rappresenta la nuova posizione. L'utilizzo di PassThru con StackName genera un oggetto PathInfoStack che rappresenta il nuovo contesto dello stack.

Note

  • Il cmdlet Set-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.

    Uno stack è un elenco first-out ultimo in cui è possibile accedere solo all'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. È possibile creare più pile di posizioni denominate. Se non si specifica un nome dello stack, PowerShell usa lo stack di percorsi 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, utilizzare i *-Location cmdlet, 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 le posizioni in uno stack di posizioni denominate, utilizzare il parametro StackName di Get-Location.

    • Per creare un nuovo stack di posizioni, utilizzare il parametro StackName di Push-Location. Se si specifica uno stack che non esiste, Push-Location crea lo stack.

    • Per impostare una pila di posizioni come quella corrente, utilizzare il parametro StackName di Set-Location.

      Lo stack di percorsi predefinito senza nome è completamente accessibile solo quando si tratta dello stack di percorsi corrente. Se si imposta uno stack di percorsi con nome nello stack di posizioni corrente, non è più possibile utilizzare Push-Location i cmdlet o Pop-Location gli strumenti per aggiungere o ottenere elementi dallo stack predefinito o per Get-Location visualizzare le posizioni nello stack senza nome. Per impostare lo stack senza nome come lo stack corrente, utilizzare il parametro StackName di Set-Location con un valore di $null o una stringa vuota ("").