Imposta il percorso di lavoro corrente su un percorso specificato.
Sintassi
Set-Location [-LiteralPath] <string> [-PassThru] [-UseTransaction] [<CommonParameters>] Set-Location [[-Path] <string>] [-PassThru] [-UseTransaction] [<CommonParameters>] Set-Location [-StackName <string>] [-PassThru] [-UseTransaction] [<CommonParameters>]
Descrizione
Il cmdlet Set-Location imposta il percorso di lavoro corrente su un percorso specificato. Può trattarsi di una directory, di una sottodirectory, di un percorso del Registro di sistema o di un altro stack di percorsi.
Parametri
-LiteralPath <string>
Specifica un nuovo percorso. Il valore del parametro LiteralPath viene utilizzato esattamente 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? |
true |
|
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>
Questo parametro viene utilizzato per impostare il percorso su un nuovo percorso di lavoro.
|
Obbligatorio? |
false |
|
Posizione? |
1 |
|
Valore predefinito |
|
|
Accettare input da pipeline? |
true (ByValue, ByPropertyName) |
|
Accettare caratteri jolly? |
false |
-StackName <string>
Nome dello stack sui cui viene impostato il percorso.
|
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 Set-Location. |
|
Output |
Nessuno o System.Management.Automation.PathInfo Quando si utilizza il parametro PassThru, Set-Location genera un oggetto System.Management.Automation.PathInfo che rappresenta il percorso. Negli altri casi, il cmdlet non genera alcun output. |
Note
Il cmdlet Set-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>set-location HKLM: Descrizione ----------- Il percorso corrente viene impostato su quello specificato, in questo caso il provider HKLM.
Esempio 2
C:\PS>set-location env: -passthru Path ---- Env:\ Descrizione ----------- Il percorso corrente viene impostato su quello specificato, in questo caso il provider di variabili di ambiente.
Esempio 3
C:\PS>set-location C: Descrizione ----------- Il percorso corrente viene impostato su quello specificato, in questo caso l'unità C: nel provider File System.
Vedere anche