Get-PSDrive
Získá jednotky v aktuální relaci.
Syntaxe
Get-PSDrive
[[-Name] <String[]>]
[-Scope <String>]
[-PSProvider <String[]>]
[<CommonParameters>]Get-PSDrive
[-LiteralName] <String[]>
[-Scope <String>]
[-PSProvider <String[]>]
[<CommonParameters>]Description
Rutina Get-PSDrive získá jednotky v aktuální relaci. V relaci můžete získat konkrétní jednotku nebo všechny jednotky.
Tato rutina získá následující typy jednotek:
- Logické jednotky Windows v počítači, včetně jednotek mapovaných na sdílené síťové složky.
- Jednotky vystavené poskytovateli PowerShellu (například Certificate:, Function:, and Alias: drive) a HKLM: a HKCU: jednotky, které jsou vystaveny poskytovatelem registru Windows PowerShellu.
- Dočasné jednotky zadané relací a trvalé mapované síťové jednotky, které vytvoříte pomocí rutiny New-PSDrive.
Počínaje windows PowerShellem 3.0 může parametr Persist rutiny New-PSDrive vytvořit mapované síťové jednotky uložené v místním počítači a jsou k dispozici v jiných relacích. Další informace najdete v článku New-PSDrive.
Kromě toho windows PowerShell 3.0, když je externí jednotka připojená k počítači, Windows PowerShell automaticky přidá PSDrive do systému souborů, který představuje novou jednotku. Windows PowerShell nemusíte restartovat. Podobně když se externí jednotka odpojí od počítače, Windows PowerShell automaticky odstraní jednotku PSDrive, která představuje odebranou jednotku.
Příklady
Příklad 1: Získání jednotek v aktuální relaci
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 VariableTento příkaz získá jednotky v aktuální relaci.
Výstup zobrazuje pevný disk (C:), jednotku CD-ROM (D:) a jednotky vystavené zprostředkovateli Windows PowerShellu (Alias:, Cert:, Env:, Function:, HKCU:, HKLM:, and Variable:).
Příklad 2: Získání jednotky v počítači
PS C:\foo> Get-PSDrive D
Name Used (GB) Free (GB) Provider Root
---- --------- --------- -------- ----
D 1211.06 123642.32 FileSystem D:\Tento příkaz načte jednotku D: v počítači. Všimněte si, že písmeno jednotky v příkazu není následované dvojtečku.
Příklad 3: Získání všech jednotek podporovaných poskytovatelem systému souborů Windows PowerShellu
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\GratefulDeadTento příkaz získá všechny jednotky podporované poskytovatelem systému souborů Windows PowerShellu. To zahrnuje pevné jednotky, logické oddíly, mapované síťové jednotky a dočasné jednotky, které vytvoříte pomocí rutiny New-PSDrive.
Příklad 4: Zkontrolujte, jestli se jednotka používá jako název jednotky Windows PowerShellu.
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
}Tento příkaz zkontroluje, jestli se jednotka X už používá jako název jednotky Windows PowerShellu.
Pokud tomu tak není, příkaz pomocí New-PSDrive rutiny vytvoří dočasnou jednotku, která je namapovaná na klíč registru HKLM:\SOFTWARE.
Příklad 5: Porovnání typů systémových jednotek souborů
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 OKTento příklad porovnává typy jednotek systému souborů, které jsou zobrazeny Get-PSDrive pomocí jiných metod. Tento příklad ukazuje různé způsoby zobrazení jednotek ve Windows PowerShellu a ukazuje, že jednotky specifické pro relaci vytvořené pomocí rutiny New-PSDrive jsou přístupné jenom v prostředí Windows PowerShell.
První příkaz použije Get-PSDrive k získání všech jednotek systému souborů v relaci. To zahrnuje pevné jednotky (C: a D:), namapovanou síťovou jednotku (G:), která byla vytvořena pomocí parametru New-PSDriveTrvalé uložení a jednotky PowerShellu (T:), které byly vytvořeny pomocí bez New-PSDrive parametru Persist.
Příkaz net use zobrazí namapované síťové jednotky windows, v tomto případě zobrazí pouze jednotku G. Nezobrazuje jednotku X: vytvořenou New-PSDrive. Ukazuje, že jednotka G: je také mapována na \\Music\GratefulDead.
Třetí příkaz používá metodu GetDrives třídy Microsoft .NET Framework System.IO.DriveInfo . Tento příkaz získá jednotky systému souborů Windows, včetně jednotky G:, ale nezískne jednotky vytvořené New-PSDrive.
Čtvrtý příkaz používá rutinu Get-CimInstance k získání instancí Win32_LogicalDisk třídy. Vrátí jednotky A:, C:, D:, E:a G, ale ne jednotky vytvořené New-PSDrive.
Poslední příkaz používá rutinu Get-CimInstance k zobrazení instancí Win32_NetworkConnection třídy. Stejně jako net use vrátí pouze trvalou jednotku G: vytvořenou New-PSDrive.
Parametry
-LiteralName
Určuje název jednotky.
Hodnota LiteralName se používá přesně tak, jak je zadána. Žádné znaky nejsou interpretovány jako zástupné znaky. Pokud název obsahuje řídicí znaky, uzavřete ho do jednoduchých uvozovek. Jednoduché uvozovky říkají prostředí Windows PowerShell, aby nepřekládaly žádné znaky jako řídicí sekvence.
| Typ: | String[] |
| Position: | 0 |
| Default value: | None |
| Vyžadováno: | True |
| Přijmout vstup kanálu: | True |
| Přijmout zástupné znaky: | False |
-Name
Určuje název nebo název jednotek, které tato rutina v operaci získá, jako pole řetězců.
Zadejte název jednotky nebo písmeno bez dvojtečky (:).
| Typ: | String[] |
| Position: | 0 |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | True |
| Přijmout zástupné znaky: | False |
-PSProvider
Určuje jako pole řetězců zprostředkovatele Windows PowerShellu. Tato rutina získá pouze jednotky podporované tímto poskytovatelem. Zadejte název zprostředkovatele, například FileSystem, Registry nebo Certificate.
| Typ: | String[] |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | True |
| Přijmout zástupné znaky: | False |
-Scope
Určuje obor, ve kterém tato rutina získá jednotky.
Tento parametr přijímá tyto hodnoty:
- Globální
- Místní
- Skript
- číslo relativní k aktuálnímu oboru (0 až počet oborů, kde 0 je aktuální obor a 1 je jeho nadřazený). "Místní" je výchozí hodnota.
Další informace najdete v tématu about_Scopes.
| Typ: | String |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | True |
| Přijmout zástupné znaky: | False |
-UseTransaction
Zahrnuje příkaz v aktivní transakci. Tento parametr je platný pouze v případě, že probíhá transakce. Další informace najdete v tématu about_Transactions.
| Typ: | SwitchParameter |
| Aliasy: | usetx |
| Position: | Named |
| Default value: | False |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
Vstupy
None
Do této rutiny nemůžete roušit objekty.
Výstupy
Tato rutina vrátí objekty představující jednotky v relaci.
Poznámky
Windows PowerShell obsahuje následující aliasy pro Get-PSDrive:
gdrTato rutina je navržená tak, aby fungovala s daty vystavenými jakýmkoli poskytovatelem. Pokud chcete zobrazit seznam poskytovatelů dostupných ve vaší relaci, použijte tuto rutinu
Get-PSProvider. Další informace najdete v tématu about_Providers.Mapované síťové jednotky vytvořené pomocí parametru Persist rutiny New-PSDrive jsou specifické pro uživatelský účet. Namapované síťové jednotky, které vytvoříte v relacích, které jsou spuštěny s možností Spustit jako správce nebo s přihlašovacími údaji jiného uživatele, nejsou viditelné v relacích, které jsou spuštěny bez explicitních přihlašovacích údajů nebo s přihlašovacími údaji aktuálního uživatele.
