Get-PSDrive

  • Referencia
Modul:
Microsoft.PowerShell.Management

Lekéri a meghajtókat az aktuális munkamenetben.

Syntax

Get-PSDrive
   [[-Name] <String[]>]
   [-Scope <String>]
   [-PSProvider <String[]>]
   [<CommonParameters>]
Get-PSDrive
   [-LiteralName] <String[]>
   [-Scope <String>]
   [-PSProvider <String[]>]
   [<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 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 á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 Perzisztencia paramétere olyan leképezett hálózati meghajtókat hozhat létre, amelyek a helyi számítógépen vannak mentve, és más munkamenetekben is elérhetők. 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:), a 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:, változó:) jeleníti meg.

2. példa: Meghajtó lekéré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éri 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 hozzárendelve.

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 fájlrendszer-meghajtók más módszerekkel megjelenített Get-PSDrive típusait. 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 az összes fájlrendszer-meghajtó lekérésére használja Get-PSDrive a munkamenetben. Ez magában foglalja a rögzített meghajtókat (C: és D:), egy leképezett hálózati meghajtót (G:), amelyet a Perzisztencia paraméter New-PSDrivehasználatával hoztak létre, valamint egy PowerShell-meghajtót (T:), amelyet a Persist paraméter nélkül hoztak létreNew-PSDrive.

A net use parancs a Windows által hozzárendelt hálózati meghajtókat jeleníti meg, ebben az esetben csak a G meghajtót jeleníti meg. Nem jelenik meg a létrehozott X: meghajtó New-PSDrive. Azt mutatja, hogy a G: meghajtó a \\Music\GratefulDead értékre is megfeleltetve van.

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 hozza létre New-PSDrivea 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, a létrehozott New-PSDrivemeghajtókat azonban nem.

Az utolsó parancs a Get-CimInstance parancsmaggal jeleníti meg a Win32_Network Csatlakozás ion osztály példányait. A nettó használathoz hasonlóan csak az állandó G: meghajtót adja vissza, amelyet a New-PSDriverendszer hozott létre.

Paraméterek

-LiteralName

Megadja a meghajtó nevét.

A LiteralName értékét pontosan a beíráskor használja a rendszer. A rendszer egyetlen karaktert sem értelmez helyettesítő karakterként. Ha a név tartalmaz escape karaktereket, csatolja egy idézőjelek közé. Az idézőjelek azt jelzik, hogy a Windows PowerShell nem értelmezi a karaktereket menekülési sorozatként.

Type:String[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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.

Type:String[]
Position:0
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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 a hatókörök számán keresztül, ahol a 0 az aktuális hatókör, az 1 pedig a szülője). Az alapértelmezett érték a "Helyi".

További információ: about_Scopes.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

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 Get-PSDrivetartalmazza:

  • Összes 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-PSProvider parancsmagot. További információ: about_Providers.

  • A New-PSDrive parancsmag Perzisztencia paraméterével létrehozott leképezett hálózati meghajtók egy felhasználói fiókra vonatkoznak. A futtatás rendszergazdai 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 olyan munkamenetekben, amelyek explicit hitelesítő adatok nélkül vagy az aktuális felhasználó hitelesítő adataival kezdődnek.