NOM
Get-PSDrive
RÉSUMÉ
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 [<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'objets vers Get-PSDrive.
SORTIES
System.Management.Automation.PSDriveInfo
Get-PSDrive retourne des objets qui représentent les lecteurs Windows Powershell dans la session.
NOTES
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:.
LIENS CONNEXES
Online version: http://go.microsoft.com/fwlink/?LinkID=113327
about_Providers
New-PSDrive
Remove-PSDrive
Get-Help
Get-Command
Get-Member
Aucun commentaire:
Enregistrer un commentaire