Get-PSDrive
Lekéri a meghajtókat az aktuális munkamenetben.
Syntax
Name (Alapértelmezett)
Get-PSDrive
[[-Name] <String[]>]
[-Scope <String>]
[-PSProvider <String[]>]
[<CommonParameters>]
LiteralName
Get-PSDrive
[-LiteralName] <String[]>
[-Scope <String>]
[-PSProvider <String[]>]
[<CommonParameters>]
Description
A Get-PSDrive parancsmag lekéri a lemezeket az aktuális munkamenetben. Egy adott meghajtót vagy az összes meghajtót lekérheti a munkamenetben.
Ez a parancsmag a következő típusú meghajtókat kapja meg:
- Windows logikai meghajtók a számítógépen, beleértve a hálózati megosztásokra leképezett meghajtókat is.
- A PowerShell-szolgáltatók által közzétett meghajtók (például a Tanúsítvány:, a Függvény:és az Alias: meghajtók) és a HKLM: és a HKCU: a Windows PowerShell beállításjegyzék-szolgáltató által közzétett meghajtók.
- A munkamenet által megadott ideiglenes meghajtók és az állandó leképezett hálózati meghajtók, amelyeket a New-PSDrive parancsmaggal hoz létre.
A Windows PowerShell 3.0-tól kezdve a parancsmag New-PSDrive paramétere létrehozhat a helyi számítógépen mentett és más munkamenetekben elérhető leképezett hálózati meghajtókat. További információ: New-PSDrive.
Emellett a Windows PowerShell 3.0-tól kezdve, amikor egy külső meghajtó csatlakozik a számítógéphez, a Windows PowerShell automatikusan hozzáad egy PSDrive-ot az új meghajtót képviselő fájlrendszerhez. Nem kell újraindítania a Windows PowerShellt. Hasonlóképpen, ha egy külső meghajtó leválasztva van a számítógépről, a Windows PowerShell automatikusan törli az eltávolított meghajtót jelképező PSDrive-ot.
Példák
1. példa: Meghajtók lekérése az aktuális munkamenetben
PS C:\> Get-PSDrive
Name Used (GB) Free (GB) Provider Root
---- --------- --------- -------- ----
Alias Alias
C 202.06 23718.91 FileSystem C:\
Cert Certificate \
D 1211.06 123642.32 FileSystem D:\
Env Environment
Function Function
HKCU Registry HKEY_CURRENT_USER
HKLM Registry HKEY_LOCAL_MACHINE
Variable Variable
Ez a parancs lekéri a meghajtókat az aktuális munkamenetben.
A kimenet a merevlemezt (C:), CD-ROM meghajtót (D:) és a Windows PowerShell-szolgáltatók által közzétett meghajtókat (Alias:, Cert:, Env:, Függvény:, HKCU:, HKLM:, és Változó:) jeleníti meg.
2. példa: Meghajtó megszerzése a számítógépen
PS C:\foo> Get-PSDrive D
Name Used (GB) Free (GB) Provider Root
---- --------- --------- -------- ----
D 1211.06 123642.32 FileSystem D:\
Ez a parancs lekérdezi a D: meghajtót a számítógépen. Vegye figyelembe, hogy a parancs meghajtóbetűjelét nem kettőspont követi.
3. példa: A Windows PowerShell fájlrendszerszolgáltatója által támogatott összes meghajtó lekérése
PS C:\> Get-PSDrive -PSProvider FileSystem
Name Used (GB) Free (GB) Provider Root
---- --------- --------- -------- ----
A A:\
C 202.06 23718.91 FileSystem C:\
D 1211.06 123642.32 FileSystem D:\
G 202.06 710.91 FileSystem \\Music\GratefulDead
Ez a parancs lekéri a Windows PowerShell Fájlrendszer szolgáltató által támogatott összes meghajtót. Ide tartoznak a rögzített meghajtók, a logikai partíciók, a leképezett hálózati meghajtók és a New-PSDrive parancsmaggal létrehozott ideiglenes meghajtók.
4. példa: Ellenőrizze, hogy egy meghajtó Windows PowerShell-meghajtónévként van-e használatban
if (Get-PSDrive X -ErrorAction SilentlyContinue) {
Write-Host 'The X: drive is already in use.'
} else {
New-PSDrive -Name X -PSProvider Registry -Root HKLM:\SOFTWARE
}
Ez a parancs ellenőrzi, hogy az X meghajtó már használatban van-e Windows PowerShell-meghajtónévként.
Ha nem, a parancs a New-PSDrive parancsmaggal hoz létre egy ideiglenes meghajtót, amely a HKLM:\SOFTWARE beállításkulcshoz van megfeleltetve.
5. példa: A fájlrendszer-meghajtók típusainak összehasonlítása
PS C:\> Get-PSDrive -PSProvider FileSystem
Name Used (GB) Free (GB) Provider Root
---- --------- --------- -------- ----
A A:\
C 202.06 23718.91 FileSystem C:\
D 1211.06 123642.32 FileSystem D:\
G 202.06 710.91 FileSystem \\Music\GratefulDead
X Registry HKLM:\Network
PS C:\> net use
New connections will be remembered.
Status Local Remote Network
-------------------------------------------------------------------------------
OK G: \\Server01\Public Microsoft Windows Network
PS C:\> [System.IO.DriveInfo]::GetDrives() | Format-Table
Name DriveType DriveFormat IsReady AvailableFreeSpace TotalFreeSpace TotalSize RootDirectory VolumeLabel
---- --------- ----------- ------- ------------------ -------------- --------- ------------- -----------
A:\ Network False A:\
C:\ Fixed NTFS True 771920580608 771920580608 988877418496 C:\ Windows
D:\ Fixed NTFS True 689684144128 689684144128 1990045179904 D:\ Big Drive
E:\ CDRom False E:\
G:\ Network NTFS True 69120000 69120000 104853504 G:\ GratefulDead
PS N:\> Get-CimInstance -Class Win32_LogicalDisk
DeviceID DriveType ProviderName VolumeName Size FreeSpace
-------- --------- ------------ ---------- ---- ---------
A: 4
C: 3 Windows 988877418496 771926069248
D: 3 Big! 1990045179904 689684144128
E: 5
G: 4 \\Music\GratefulDead 988877418496 771926069248
PS C:\> Get-CimInstance -Class Win32_NetworkConnection
LocalName RemoteName ConnectionState Status
--------- ---------- --------------- ------
G: \\Music\GratefulDead Connected OK
Ez a példa összehasonlítja a Get-PSDrive által megjelenített fájlrendszer-meghajtók típusait más módszerekkel megjelenítettekkel. Ez a példa a meghajtók Windows PowerShellben való megjelenítésének különböző módjait mutatja be, és azt mutatja be, hogy a New-PSDrive parancsmaggal létrehozott munkamenet-specifikus meghajtók csak a Windows PowerShellben érhetők el.
Az első parancs Get-PSDrive használ a munkamenet összes fájlrendszer-meghajtójának lekéréséhez. Ez magában foglalja a rögzített meghajtókat (C: és D:), egy leképezett hálózati meghajtót (G:), amelyet a Persist paraméter használatával hoztak létre a New-PSDrive, valamint egy PowerShell-meghajtót (T:), amelyet a New-PSDrive használatával hoztak létre a Persist paraméter nélkül.
A net use parancs windowsos hálózati meghajtókat jelenít meg, ebben az esetben csak a G meghajtót jeleníti meg. Nem jelenik meg a New-PSDriveáltal létrehozott X: meghajtó. Azt mutatja, hogy a G: meghajtó is hozzá van rendelve a \\Music\GratefulDead-hoz.
A harmadik parancs a Microsoft .NET-keretrendszer System.IO.DriveInfo osztály GetDrives metódusát használja. Ez a parancs lekéri a Windows fájlrendszerbeli meghajtókat, beleértve a G: meghajtót is, de nem kapja meg a New-PSDriveáltal létrehozott meghajtókat.
A negyedik parancs a Get-CimInstance parancsmagot használja a Win32_LogicalDisk osztály példányainak lekéréséhez. Az A:, C:, D:, E:és G: meghajtókat adja vissza, de a New-PSDriveáltal létrehozott meghajtókat nem.
Az utolsó parancs a Get-CimInstance parancsmaggal jeleníti meg a Win32_NetworkConnection osztály példányait. A net use-hez hasonlóan csak a New-PSDriveáltal létrehozott állandó G: meghajtót adja vissza.
Paraméterek
-LiteralName
Megadja a meghajtó nevét.
A LiteralName értéke pontosan a beíráskor lesz használva. A rendszer egyetlen karaktert sem értelmez helyettesítő karakterként. Ha a név tartalmaz escape karaktereket, vegye egyes idézőjelek közé. Az idézőjelek azt jelzik, hogy a Windows PowerShell nem értelmezi a karaktereket menekülési sorozatként.
Paramétertulajdonságok
| Típus: | String[] |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
LiteralName
| Position: | 0 |
| Kötelező: | True |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | True |
| Fennmaradó argumentumokból származó érték: | False |
-Name
Sztringtömbként megadja a parancsmag által a műveletbe beszúrt meghajtók nevét vagy nevét.
Írja be a meghajtó nevét vagy betűjelét kettőspont (:) nélkül.
Paramétertulajdonságok
| Típus: | String[] |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
Name
| Position: | 0 |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | True |
| Fennmaradó argumentumokból származó érték: | False |
-PSProvider
Sztringtömbként megadja a Windows PowerShell-szolgáltatót. Ez a parancsmag csak a szolgáltató által támogatott meghajtókat kapja meg. Írja be a szolgáltató nevét, például a Fájlrendszert, a Beállításjegyzéket vagy a Tanúsítványt.
Paramétertulajdonságok
| Típus: | String[] |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | True |
| Fennmaradó argumentumokból származó érték: | False |
-Scope
Azt a hatókört adja meg, amelyben ez a parancsmag lekéri a meghajtókat.
A paraméter elfogadható értékei a következők:
- Globális
- Helyi
- Szkript
- az aktuális hatókörhöz viszonyított szám (0-tól a hatókörök számáig terjedően, ahol a 0 az aktuális hatókör és az 1 annak szülője). Az alapértelmezett érték a "Helyi".
További információ található a about_Scopesrészben.
Paramétertulajdonságok
| Típus: | String |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | True |
| Fennmaradó argumentumokból származó érték: | False |
CommonParameters
Ez a parancsmag a következő gyakori paramétereket támogatja: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction és -WarningVariable. További információért lásd about_CommonParameters.
Bevitelek
None
Ehhez a parancsmaghoz nem lehet objektumokat csövezni.
Kimenetek
PSDriveInfo
Ez a parancsmag a munkamenet meghajtóit képviselő objektumokat adja vissza.
Jegyzetek
A PowerShell a következő aliasokat tartalmazza Get-PSDrive:
Minden platform:
gdr
Ez a parancsmag úgy lett kialakítva, hogy bármely szolgáltató által közzétett adatokkal működjön együtt. A munkamenetben elérhető szolgáltatók listájához használja a
Get-PSProviderparancsmagot. További információért lásd a about_Providerscímű részt.A New-PSDrive parancsmag Persist paraméterével létrehozott leképezett hálózati meghajtók egy felhasználói fiókra vonatkoznak. A 'Rendszergazdaként futtatás' beállítással vagy egy másik felhasználó hitelesítő adataival indított munkamenetekben létrehozott leképezett hálózati meghajtók nem láthatók azokban a munkamenetekben, amelyek explicit hitelesítő adatok nélkül vagy az aktuális felhasználó hitelesítő adataival indulnak.