Obtient les lecteurs Windows PowerShell présents dans la session active.

Syntaxe

Get-PSDrive [-LiteralName] <string[]> [-PSProvider <string[]>] [-Scope <string>] [-UseTransaction] [<CommonParameters>]

Get-PSDrive [[-Name] <string[]>] [-PSProvider <string[]>] [-Scope <string>] [-UseTransaction] [<CommonParameters>]

Description

L'applet de commande Get-PSDrive obtient les lecteurs Windows PowerShell présents dans la session active. Vous pouvez obtenir un lecteur particulier ou l'ensemble des lecteurs présents dans la console.

Get-PSDrive obtient les lecteurs suivants :

-- lecteurs logiques Windows sur l'ordinateur, notamment les lecteurs mappés aux partages réseau ;

-- lecteurs exposés par les fournisseurs Windows PowerShell (lecteurs Certificate:, Function: et Alias:) et lecteurs HKLM: et HKCU: exposés par le fournisseur Registry de Windows PowerShell ;

-- lecteurs que vous créez à l'aide de New-PSDrive.

Get-PSDrive n'obtient pas les lecteurs mappés Windows qui sont ajoutés ou créés après l'ouverture de la console Windows PowerShell.

Paramètres

-LiteralName <string[]>

Spécifie le nom du lecteur Windows PowerShell.

La valeur de -LiteralName est utilisée exactement telle que vous la tapez. Aucun caractère n'est interprété en tant que caractère générique. Si le nom 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

-Name <string[]>

Obtient uniquement les lecteurs spécifiés. Tapez la lettre ou le nom du lecteur sans les deux-points (:).

Obligatoire ?

false

Position ?

1

Valeur par défaut

Accepter l'entrée de pipeline ?

true (ByPropertyName)

Accepter les caractères génériques ?

false

-PSProvider <string[]>

Obtient uniquement les lecteurs pris en charge par le fournisseur Windows PowerShell spécifié. Tapez le nom d'un fournisseur (FileSystem, Registry ou Certificate, par exemple).

Obligatoire ?

false

Position ?

named

Valeur par défaut

Accepter l'entrée de pipeline ?

true (ByPropertyName)

Accepter les caractères génériques ?

false

-Scope <string>

Obtient uniquement les lecteurs Windows PowerShell présents dans la portée spécifiée. Les valeurs valides sont « Global », « Local » ou « Script », ou un nombre relatif à la portée actuelle (0 jusqu'au nombre de portées, où 0 est la portée actuelle et 1 son parent). « Local » est la valeur par défaut. Pour plus d'informations, consultez about_Scopes.

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'objets vers Get-PSDrive.

Sorties

System.Management.Automation.PSDriveInfo

Get-PSDrive retourne des objets qui représentent les lecteurs Windows Powershell dans la session.

Remarques

L'applet de commande Get-PSDrive 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-psdrive

Name       Provider      Root
----       --------      ----
Alias      Alias
C          FileSystem    C:\
cert       Certificate   \
D          FileSystem    D:\
Env        Environment
Function   Function
HKCU       Registry      HKEY_CURRENT_USER
HKLM       Registry      HKEY_LOCAL_MACHINE
Variable   Variable
X          FileSystem    X:\

Description
-----------
Cette commande obtient les lecteurs Windows PowerShell présents dans la session active. 

La sortie indique le disque dur (C:) et le lecteur de CD-ROM (D:) sur l'ordinateur, les lecteurs exposés par les fournisseurs Windows PowerShell (Alias:, Cert:, Env:, Function:, HKCU:, HKLM: et Variable:) et un lecteur mappé à un partage réseau (X:).






Exemple 2

C:\PS>get-psdrive d

Name       Provider      Root
----       --------      ----
D          FileSystem    D:\

Description
-----------
Cette commande affiche le lecteur D: sur l'ordinateur. Notez que la lettre de lecteur n'est pas suivie de deux-points.






Exemple 3

C:\PS>get-psdrive -psprovider filesystem

Name       Provider      Root
----       --------      ----
C          FileSystem    C:\
D          FileSystem    D:\
X          FileSystem    X:\
Y          FileSystem    \\Server01\Public
Z          FileSystem    C:\Windows\System32

Description
-----------
Cette commande affiche tous les lecteurs qui sont pris en charge par le fournisseur FileSystem de Windows PowerShell. En font partie les lecteurs fixes, les partitions logiques, les lecteurs réseau mappés et les lecteurs que vous créez à l'aide de New-PSDrive et qui sont mappés aux lecteurs de système de fichiers.

Cet exemple montre que les lecteurs créés par New-PSDrive portent le nom de l'emplacement mappé dans la valeur de la propriété Root. Les lecteurs Windows disposent simplement de la racine de la lettre de lecteur.






Exemple 4

C:\PS>if (!(get-psdrive X)) { 
    new-psdrive -name X -psprovider Registry -root HKLM:\Network 
}
else { write-host "The X: drive is already in use." }

Description
-----------
Cette commande vérifie si le lecteur X est déjà utilisé en tant que nom de lecteur Windows PowerShell. Si ce n'est pas le cas, la commande utilise l'applet de commande New-PSDrive pour créer un lecteur Windows PowerShell mappé à la clé de Registre HKLM:\Network.






Exemple 5

C:\PS>get-psdrive -provider filesystem

C:\PS> get-psdrive -provider filesystem

Name       Provider      Root
----       --------      ----
C          FileSystem    C:\
D          FileSystem    D:\
X          FileSystem    X:\
Y          FileSystem    \\Server01\Public
Z          FileSystem    C:\Windows\System32

C:\PS> net use
New connections will be remembered.

Status       Local     Remote                    Network
-------------------------------------------------------------------------------
             X:        \\Server01\Public         Microsoft Windows Network


C:\PS> [System.IO.DriveInfo]::getdrives()

Name               : C:\
DriveType          : Fixed
DriveFormat        : NTFS
IsReady            : True
AvailableFreeSpace : 39831498752
TotalFreeSpace     : 39831498752
TotalSize          : 79900368896
RootDirectory      : C:\
VolumeLabel        :
Name               : D:\
DriveType          : CDRom
DriveFormat        :
IsReady            : False
AvailableFreeSpace :
TotalFreeSpace     :
TotalSize          :
RootDirectory      : D:\
VolumeLabel        :
Name               : X:\
DriveType          : Network
DriveFormat        : NTFS
IsReady            : True
AvailableFreeSpace : 36340559872
TotalFreeSpace     : 36340559872
TotalSize          : 36413280256
RootDirectory      : X:\
VolumeLabel        : D_Drive


C:\PS> get-wmiobject win32_logicaldisk

DeviceID     : C:
DriveType    : 3
ProviderName :
FreeSpace    : 39831252992
Size         : 79900368896
VolumeName   :
DeviceID     : D:
DriveType    : 5
ProviderName :
FreeSpace    :
Size         :
VolumeName   :
DeviceID     : X:
DriveType    : 4
ProviderName : \\server01\public
FreeSpace    : 36340559872
Size         : 36413280256
VolumeName   : D_Drive


C:\PS> get-wmiobject win32_networkconnection
LocalName                     RemoteName                    
--------------               ------------
x:                            \\server01\public

Description
-----------
Cet exemple compare les types de lecteurs de système de fichiers qui sont affichés par Get-PSDrive à ceux affichés à l'aide d'autres méthodes. Cet exemple montre différentes manières d'afficher des lecteurs dans Windows PowerShell et il montre que les lecteurs créés à l'aide de New-PSDrive sont uniquement accessibles dans Windows PowerShell.

La première commande utilise Get-PSDrive pour placer tous les lecteurs de système de fichiers dans la console Windows PowerShell. En font partie les lecteurs fixes (C: et D:), le lecteur réseau mappé (X:) et deux lecteurs Windows PowerShell (O: et Z:) qui ont été créés à l'aide de New-PsDrive.

Une commande net use, qui affiche les lecteurs réseau mappés Windows, affiche uniquement le lecteur X. Elle n'affiche pas les lecteurs qui ont été créés par New-PSDrive. Elle indique que le lecteur X: est également mappé à \\Server01\Public.

La troisième commande utilise la méthode GetDrives de la classe Microsoft .NET Framework System.IO.DriveInfo. Cette commande obtient les lecteurs de système de fichiers Windows, notamment le lecteur X:, mais elle n'obtient pas les lecteurs créés par New-PSDrive.

La quatrième commande utilise l'applet de commande Get-WmiObject pour afficher les instances de la classe Win32_LogicalDisk. Elle retourne les lecteurs C:, D: et X:, mais pas les lecteurs créés par New-PSDrive.

La dernière commande utilise l'applet de commande Get-WmiObject pour afficher les instances de la classe Win32_NetworkConnection. Comme la commande net use, elle retourne uniquement le lecteur X:.






Voir aussi




Table des matières