Obtient des informations à propos de l'emplacement de travail actif.

Syntaxe

Get-Location [-PSDrive <string[]>] [-PSProvider <string[]>] [-UseTransaction] [<CommonParameters>]

Get-Location [-Stack] [-StackName <string[]>] [-UseTransaction] [<CommonParameters>]

Description

L'applet de commande Get-Location obtient un objet qui représente le répertoire actif, à la manière de la commande pwd (print working directory).

Lorsque vous passez d'un lecteur Windows PowerShell à un autre, Windows PowerShell conserve votre emplacement sur chaque lecteur. Vous pouvez utiliser Get-Location pour rechercher votre emplacement sur chaque lecteur.

Vous pouvez également utiliser Get-Location pour obtenir le répertoire actif au moment de l'exécution et l'utiliser dans des fonctions et des scripts (dans une fonction qui affiche le répertoire actif dans l'invite de Windows PowerShell, par exemple).

Si vous utilisez l'applet de commande Push-Location pour ajouter des emplacements à une pile de chemins d'accès, vous pouvez utiliser le paramètre Stack de Get-Location pour afficher la pile active.

Paramètres

-PSDrive <string[]>

Obtient l'emplacement actuel sur le lecteur Windows PowerShell spécifié.

Par exemple, si vous êtes sur le lecteur Certificate:, vous pouvez utiliser ce paramètre pour rechercher votre emplacement actuel sur le lecteur C:

Obligatoire ?

false

Position ?

named

Valeur par défaut

Accepter l'entrée de pipeline ?

true (ByPropertyName)

Accepter les caractères génériques ?

false

-PSProvider <string[]>

Obtient l'emplacement actuel sur le lecteur pris en charge par le fournisseur Windows PowerShell spécifié.

Si le fournisseur spécifié prend en charge plusieurs lecteurs, Get-Location retourne l'emplacement sur le lecteur le plus récemment utilisé.

Par exemple, si vous êtes sur le lecteur C:, vous pouvez utiliser ce paramètre pour rechercher votre emplacement actuel sur les lecteurs du fournisseur Registry de Windows PowerShell.

Obligatoire ?

false

Position ?

named

Valeur par défaut

Accepter l'entrée de pipeline ?

true (ByPropertyName)

Accepter les caractères génériques ?

false

-Stack

Affiche les emplacements dans la pile de chemins d'accès par défaut.

Pour ajouter des chemins d'accès à la pile par défaut, utilisez l'applet de commande Push-Location.

Obligatoire ?

false

Position ?

named

Valeur par défaut

Accepter l'entrée de pipeline ?

false

Accepter les caractères génériques ?

false

-StackName <string[]>

Affiche les emplacements dans les piles de chemins d'accès spécifiées.

Pour créer des piles de chemins d'accès, utilisez l'applet de commande Push-Location.

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

None

Vous ne pouvez pas diriger d'entrée vers cette applet de commande.

Sorties

Objets PathInfo ou objets StackInfo

Si vous utilisez les paramètres Stack ou StackName, Get-Location retourne un objet StackInfo. Sinon, elle retourne un objet PathInfo.

Remarques

Les emplacements peuvent être stockés sur une pile. L'applet de commande Push-Location ajoute un emplacement au sommet de la pile. L'applet de commande Pop-Location obtient l'emplacement en haut de la pile.

L'interaction entre les paramètres PSProvider, PSDrive, Stack et StackName varie en fonction du fournisseur. Certaines combinaisons provoquent des erreurs, par exemple la spécification d'un lecteur et d'un fournisseur qui n'expose pas ce lecteur. Si aucun paramètre n'est spécifié, Get-Location retourne l'objet PathInfo du fournisseur contenant l'emplacement de travail actif.

L'applet de commande Get-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>get-location

Path
----
C:\WINDOWS

Description
-----------
Cette commande affiche votre emplacement sur le lecteur Windows PowerShell actif.

Par exemple, si vous êtes sur le répertoire Windows du lecteur C:, elle affiche le chemin d'accès de ce répertoire.

Exemple 2

C:\PS>set-location

Description
-----------
Ces commandes montrent l'utilisation de Get-Location pour afficher votre emplacement actuel sur différents lecteurs Windows PowerShell.

La première commande utilise l'applet de commande Set-Location pour définir l'emplacement actuel sur le sous-répertoire Windows du lecteur C:.

    C:\PS> set-location C:\Windows

La deuxième commande utilise l'applet de commande Set-Location pour modifier l'emplacement sur la clé de Registre HKLM:\Software\Microsoft. Lorsque vous changez d'emplacement sur le lecteur HKLM:, Windows PowerShell conserve votre emplacement sur le lecteur C:. 

    PS C:\WINDOWS> set-location HKLM:\Software\Microsoft
    PS HKLM:\Software\Microsoft>

La troisième commande utilise l'applet de commande Set-Location pour modifier l'emplacement sur la clé de Registre HKCU:\Control Panel\Input Method.

    PS HKLM:\Software\Microsoft> set-location 'HKCU:\Control Panel\Input Method'
    PS HKCU:\Control Panel\Input Method>

La quatrième commande utilise l'applet de commande Get-Location pour rechercher l'emplacement actuel sur le lecteur C:. Elle utilise le paramètre PSDrive pour spécifier le lecteur.

    PS HKCU:\Control Panel\Input Method> get-location -psdrive c
    Path
    ----
    C:\WINDOWS

La cinquième commande utilise l'applet de commande Set-Location pour revenir au lecteur C:. Même si la commande ne spécifie pas de sous-répertoire, Windows PowerShell vous renvoie à l'emplacement enregistré.

    PS HKCU:\Control Panel\Input Method> set-location C:
    PS C:\WINDOWS>

La sixième commande utilise l'applet de commande Get-Location pour rechercher l'emplacement actuel sur les lecteurs pris en charge par le fournisseur Registry de Windows PowerShell. Get-Location retourne l'emplacement du dernier lecteur de Registre utilisé (HKCU:).

    PS C:\WINDOWS> get-location -psprovider registry
    Path
    ----
    HKCU:\Control Panel\Input Method

Pour afficher l'emplacement actuel sur le HKLM:, vous devez utiliser le paramètre PSDrive pour spécifier le lecteur. C'est précisément ce que fait la septième commande :

    PS C:\WINDOWS> get-location -psdrive HKLM
    Path
    ----
    HKLM:\Software\Microsoft

Exemple 3

C:\PS>set-location

Description
-----------
Ces commandes indiquent comment utiliser les paramètres Stack et StackName de Get-Location pour répertorier les chemins d'accès des piles de chemins d'accès par défaut et secondaires.

La première commande définit l'emplacement actuel du répertoire Windows sur le lecteur C:.
    
    C:\PS> set-location C:\Windows 

La deuxième commande utilise l'applet de commande Push-Location pour placer l'emplacement actuel (C:\Windows) sur la pile de chemins d'accès et le changer en sous-répertoire System32. Comme aucune pile n'est spécifiée, l'emplacement actuel est placé sur la pile par défaut.
    C:\WINDOWS>push-location System32

La troisième commande place l'emplacement actuel (C:\Windows\System32) sur la pile Stack2 et le change en sous-répertoire WindowsPowerShell.
    
    C:\Windows\System32>push-location WindowsPowerShell -stack Stack2

La quatrième commande utilise l'applet de commande Get-Location pour obtenir les chemins d'accès de la pile de chemins d'accès par défaut.
    
    C:\WINDOWS\system32\WindowsPowerShell>get-location -stack

    Path
    ----
    C:\WINDOWS

La dernière commande utilise le paramètre StackName de Get-Location pour obtenir les chemins d'accès de la pile Stack2.
    
    C:\WINDOWS\system32\WindowsPowerShell>get-location -stackname Stack2

    Path
    ----
    C:\WINDOWS\system32

Exemple 4

C:\PS>function prompt { 'PowerShell: ' + (get-location) + '> '}

PowerShell: C:\WINDOWS>

Description
-----------
Cet exemple montre comment personnaliser l'invite de Windows PowerShell. La fonction qui définit l'invite inclut une commande Get-Location, qui s'exécute à chaque affichage de l'invite dans la console.

Le format de l'invite de Windows PowerShell par défaut est défini par une fonction spéciale appelée « prompt ». Vous pouvez modifier l'invite dans votre console en créant une fonction appelée « prompt ».

Pour consulter la fonction d'invite active, tapez la commande suivante :
 
    get-content function:prompt

La commande commence par le mot clé « function » suivi du nom de la fonction, « prompt ». Le corps de la fonction s'affiche entre accolades ( {} ). 

Cette commande définit une nouvelle invite qui commence par la chaîne « PowerShell:  ». Pour ajouter l'emplacement actuel, elle utilise une commande Get-Location, qui s'exécute lorsque la fonction prompt est appelée. L'invite se termine par la chaîne « >  ».

Voir aussi



Table des matières