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