Get-PSDrive
Lekéri a meghajtókat az aktuális munkamenetben.
Syntax
Name (Alapértelmezett)
Get-PSDrive
[[-Name] <String[]>]
[-Scope <String>]
[-PSProvider <String[]>]
[-UseTransaction]
[<CommonParameters>]
LiteralName
Get-PSDrive
[-LiteralName] <String[]>
[-Scope <String>]
[-PSProvider <String[]>]
[-UseTransaction]
[<CommonParameters>]
Description
A Get-PSDrive parancsmag lekéri a meghajtókat 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 Windows 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), valamint 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 kezdődően a New-PSDrive parancsmag Megőrzése paramétere képes a helyi számítógépen mentett és más munkamenetekben elérhető leképezett hálózati meghajtók létrehozására. 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 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
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:\> Get-PSDrive D
Name Provider Root
---- -------- ----
D 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 Provider Root
---- -------- ----
C FileSystem C:\
D FileSystem D:\
X FileSystem X:\
Y FileSystem \\Server01\Public
Z FileSystem C:\Windows\System32
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 Provider Root
---- -------- ----
C FileSystem C:\
D FileSystem D:\
X FileSystem X:\
Y FileSystem \\Server01\Public
Z FileSystem C:\Windows\System32
PS C:\> net use
New connections will be remembered.
Status Local Remote Network
-------------------------------------------------------------------------------
X: \\Server01\Public Microsoft Windows Network
PS C:\> [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
PS C:\> 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
PS C:\> Get-WmiObject Win32_NetworkConnection
LocalName RemoteName
-------------- ------------
x: \\server01\public
Ez a példa összehasonlítja a Get-PSDrive által megjelenített fájlrendszer-meghajtók típusait más módszerekkel. 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 ideiglenes, munkamenet-specifikus meghajtók csak a Windows PowerShellben érhetők el.
Az első parancs Get-PSDrive használatával szerzi be az összes fájlrendszer-meghajtót a munkamenetben. Ez magában foglalja a rögzített meghajtókat (C: és D:), egy leképezett hálózati meghajtót (X:), amelyet a New-PSDrive New-PSDrivePersist paraméterével hoztak létre, valamint két ideiglenes Windows PowerShell-meghajtót (Y: és Z:), amelyeket New-PSDrive használatával hoztak létre a Megőrzése paraméter nélkül.
A windowsos leképezett hálózati meghajtókat megjelenítő net use parancs csak az X meghajtót jeleníti meg.
Nem jeleníti meg a New-PSDrive
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ájlrendszer meghajtóit, beleértve az X: meghajtót is, de nem kapja meg a New-PSDrive
A negyedik parancs a Get-WmiObject parancsmagot használja a Win32_LogicalDisk osztály példányainak lekéréséhez.
A C:, D:és X: meghajtókat adja vissza, a New-PSDrive
Az utolsó parancs a Get-WmiObject parancsmaggal jeleníti meg a Win32_NetworkConnection osztály példányait. A nettó használathoz hasonlóan csak az állandó X: meghajtót adja vissza, amelyet New-PSDrivehozott létre.
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ó: about_Scopes (https://go.microsoft.com/fwlink/?LinkID=113260).
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 |
-UseTransaction
Tartalmazza a parancsot az aktív tranzakcióban. Ez a paraméter csak akkor érvényes, ha egy tranzakció folyamatban van. További információ: about_Transactions.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | False |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
| Aliasok: | usetx |
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: | False |
| 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 olyan objektumokat ad vissza, amelyek a munkamenetben lévő meghajtókat jelölik.
Jegyzetek
- 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-PSProvider parancsmagot. 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.