Définit l'emplacement de travail actif sur un emplacement spécifié.

Syntaxe

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

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

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

Description

L'applet de commande Set-Location définit l'emplacement de travail actif sur un emplacement spécifié. Cet emplacement peut être un répertoire, un sous-répertoire, un emplacement dans le Registre ou une autre pile d'emplacements.

Paramètres

-LiteralPath <string>

Spécifie un chemin d'accès à l'emplacement. La valeur du paramètre LiteralPath est utilisée exactement comme elle est tapée. Aucun caractère n'est interprété en tant que caractère générique. Si le chemin d'accès inclut des caractères d'échappement, mettez-le entre des guillemets simples. Les guillemets simples indiquent à Windows PowerShell qu'aucun caractère ne doit être interprété en tant que séquence d'échappement.

Obligatoire ?

true

Position ?

1

Valeur par défaut

Accepter l'entrée de pipeline ?

true (ByPropertyName)

Accepter les caractères génériques ?

false

-PassThru

Passe un objet représentant l'emplacement au pipeline. Par défaut, cette applet de commande ne génère aucune sortie.

Obligatoire ?

false

Position ?

named

Valeur par défaut

Accepter l'entrée de pipeline ?

false

Accepter les caractères génériques ?

false

-Path <string>

Ce paramètre est utilisé pour spécifier le chemin d'accès à un nouvel emplacement de travail.

Obligatoire ?

false

Position ?

1

Valeur par défaut

Accepter l'entrée de pipeline ?

true (ByValue, ByPropertyName)

Accepter les caractères génériques ?

false

-StackName <string>

Nom de la pile sur laquelle l'emplacement est défini.

Obligatoire ?

false

Position ?

named

Valeur par défaut

Accepter l'entrée de pipeline ?

true (ByPropertyName)

Accepter les caractères génériques ?

false

-UseTransaction

Inclut la commande dans la transaction active. Ce paramètre est valide uniquement lorsqu'une transaction est en cours. Pour plus d'informations, consultez about_Transactions.

Obligatoire ?

false

Position ?

named

Valeur par défaut

Accepter l'entrée de pipeline ?

false

Accepter les caractères génériques ?

false

<CommonParameters>

Cette applet de commande prend en charge les paramètres courants : -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer et -OutVariable. Pour plus d'informations, consultez about_Commonparameters.

Entrées et sorties

Le type d'entrée est le type des objets que vous pouvez diriger vers l'applet de commande. Le type de retour est le type des objets que l'applet de commande retourne.

Entrées

System.String

Vous pouvez diriger une chaîne qui contient un chemin d'accès (mais pas un chemin d'accès littéral) vers Set-Location.

Sorties

Aucun ou System.Management.Automation.PathInfo

Lorsque vous utilisez le paramètre PassThru, Set-Location génère un objet System.Management.Automation.PathInfo qui représente l'emplacement. Sinon, cette applet de commande ne génère aucune sortie.

Remarques

L'applet de commande Set-Location est conçue pour utiliser les données exposées par n'importe quel fournisseur. Pour répertorier les fournisseurs disponibles dans votre session, tapez « Get-PSProvider ». Pour plus d'informations, consultez about_Providers.

Exemple 1

C:\PS>set-location HKLM:

Description
-----------
Cette commande définit l'emplacement actuel sur l'emplacement spécifié ; dans ce cas précis, il s'agit du fournisseur HKLM.






Exemple 2

C:\PS>set-location env: -passthru

Path
----
Env:\

Description
-----------
Cette commande définit l'emplacement actuel sur l'emplacement spécifié ; dans ce cas précis, il s'agit du fournisseur de variables d'environnement.






Exemple 3

C:\PS>set-location C:

Description
-----------
Cette commande définit l'emplacement actuel sur l'emplacement spécifié ; dans ce cas précis, il s'agit du lecteur C: du fournisseur de système de fichiers (FileSystem).






Voir aussi




Table des matières