NOM
Get-Location
RÉSUMÉ
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 [<SwitchParameter>]
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 [<SwitchParameter>]
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, WarningAction, WarningVariable,
OutBuffer et OutVariable. Pour plus d'informations, tapez
« get-help about_commonparameters ».
ENTRÉES
Aucun
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.
NOTES
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 fournisse ur 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 « > ».
LIENS CONNEXES
Online version: http://go.microsoft.com/fwlink/?LinkID=113321
about_Providers
Pop-Location
Push-Location
Set-Location
Aucun commentaire:
Enregistrer un commentaire