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




Argomenti della Guida