Get-PSDrive
Ruft Laufwerke in der aktuellen Sitzung ab.
Syntax
Get-PSDrive
[[-Name] <String[]>]
[-Scope <String>]
[-PSProvider <String[]>]
[<CommonParameters>]
Get-PSDrive
[-LiteralName] <String[]>
[-Scope <String>]
[-PSProvider <String[]>]
[<CommonParameters>]
Beschreibung
Das Get-PSDrive
Cmdlet ruft die Laufwerke in der aktuellen Sitzung ab. Sie können ein bestimmtes Laufwerk oder alle Laufwerke in der Sitzung abrufen.
Dieses Cmdlet ruft die folgenden Typen von Laufwerken ab:
- Logische Windows-Laufwerke auf dem Computer, einschließlich Laufwerken, die netzwerkfreigaben zugeordnet sind.
- Laufwerke, die von PowerShell-Anbietern verfügbar gemacht werden (z. B. Zertifikat:, Funktion und Alias: Laufwerke) und HKLM: und HKCU: Laufwerke, die vom Windows PowerShell Registrierungsanbieter verfügbar gemacht werden.
- Sitzungsspezifische temporäre Laufwerke und persistent zugeordnete Netzwerklaufwerke, die Sie mithilfe des Cmdlets New-PSDrive erstellen.
Ab Windows PowerShell 3.0 kann der Persist-Parameter des New-PSDrive
Cmdlets zugeordnete Netzwerklaufwerke erstellen, die auf dem lokalen Computer gespeichert sind und in anderen Sitzungen verfügbar sind. Weitere Informationen finden Sie unter New-PSDrive.
Ab Windows PowerShell 3.0 wird beim Herstellen einer Verbindung zwischen einem externen Laufwerk und dem Computer außerdem von Windows PowerShell automatisch ein PowerShell-Laufwerk (PSDrive) zum Dateisystem hinzugefügt, das das neue Laufwerk darstellt. Windows PowerShell muss nicht neu gestartet werden. Ebenso wird beim Trennen der Verbindung zwischen einem externen Laufwerk und dem Computer das PSDrive, das das entfernte Laufwerk darstellt, von Windows PowerShell automatisch gelöscht.
Beispiele
Beispiel 1: Abrufen von Laufwerken in der aktuellen Sitzung
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
Dieser Befehl ruft die Laufwerke in der aktuellen Sitzung ab.
Die Ausgabe zeigt die Festplatte (C:), CD-ROM-Laufwerk (D:) und die Laufwerke, die von den Windows PowerShell Anbietern verfügbar gemacht werden (Alias:, Cert:, Env:, Function:, HKCU:, HKLM:, and Variable:).
Beispiel 2: Abrufen eines Laufwerks auf dem Computer
PS C:\foo> Get-PSDrive D
Name Used (GB) Free (GB) Provider Root
---- --------- --------- -------- ----
D 1211.06 123642.32 FileSystem D:\
Mit diesem Befehl wird das Laufwerk %%amp;quot;D:%%amp;quot; auf dem Computer abgerufen. Achten Sie darauf, dass im Befehl nach dem Laufwerkbuchstaben kein Doppelpunkt folgt.
Beispiel 3: Abrufen aller Laufwerke, die vom Windows PowerShell Dateisystemanbieter unterstützt werden
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
Dieser Befehl ruft alle Laufwerke ab, die vom Windows PowerShell-FileSystem-Anbieter unterstützt werden. Dazu gehören feste Laufwerke, logische Partitionen, zugeordnete Netzwerklaufwerke und temporäre Laufwerke, die Sie mithilfe des Cmdlets New-PSDrive erstellen.
Beispiel 4: Überprüfen, ob ein Laufwerk als Windows PowerShell Laufwerksname verwendet wird
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
}
Dieser Befehl überprüft, ob das Laufwerk %%amp;quot;X%%amp;quot; bereits als Windows PowerShell-Laufwerkname verwendet wird.
Wenn dies nicht der Vorgang ist, verwendet der Befehl das New-PSDrive
Cmdlet, um ein temporäres Laufwerk zu erstellen, das dem HKLM:\SOFTWARE-Registrierungsschlüssel zugeordnet ist.
Beispiel 5: Vergleichen der Typen von Dateisystemlaufwerken
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
In diesem Beispiel werden die Typen von Dateisystemlaufwerken verglichen Get-PSDrive
, die mithilfe anderer Methoden angezeigt werden. In diesem Beispiel werden verschiedene Möglichkeiten zum Anzeigen von Laufwerken in Windows PowerShell veranschaulicht, und es wird gezeigt, dass sitzungsspezifische Laufwerke, die mithilfe des Cmdlets New-PSDrive erstellt werden, nur in Windows PowerShell zugänglich sind.
Der erste Befehl verwendet Get-PSDrive
, um alle Dateisystemlaufwerke in der Sitzung abzurufen. Dazu gehören die Festen Laufwerke (C: und D:), ein zugeordnetes Netzwerklaufwerk (G:) das mithilfe des Persist-Parameters von New-PSDrive
, und eines PowerShell-Laufwerks (T:) erstellt wurde das ohne New-PSDrive
den Persist-Parameter erstellt wurde.
Der Befehl "Net Use " zeigt windows zugeordnete Netzwerklaufwerke an. In diesem Fall wird nur das G-Laufwerk angezeigt. Es zeigt nicht das X:-Laufwerk an, das von New-PSDrive
. Es zeigt, dass das Laufwerk G: auch \\Music\GratefulDead zugeordnet ist.
Der dritte Befehl verwendet die GetDrives-Methode der System.IO.DriveInfo-Klasse von Microsoft .NET Framework. Dieser Befehl ruft die Windows-Dateisystemlaufwerke ab, einschließlich Laufwerk G:, aber es ruft nicht die Laufwerke ab, die von New-PSDrive
.
Im vierten Befehl werden mit dem Cmdlet Get-CimInstance
die Instanzen der Klasse Win32_LogicalDisk abgerufen. Es gibt die Laufwerke A:, C:, D:, E:und G: zurück, aber nicht die Laufwerke, die von New-PSDrive
.
Im letzten Befehl werden mit dem Cmdlet Get-CimInstance
die Instanzen der Klasse Win32_NetworkConnection angezeigt. Wie net use, it returns only the persistent G: drive created by New-PSDrive
.
Parameter
-LiteralName
Gibt den Namen des Laufwerks an.
Der Wert von LiteralName wird genau so verwendet, wie er eingegeben wurde. Es werden keine Zeichen als Platzhalter interpretiert. Wenn der Name Escapezeichen enthält, müssen Sie ihn in einfache Anführungszeichen einschließen. Einfache Anführungszeichen veranlassen Windows PowerShell, Zeichen nicht als Escapesequenzen zu interpretieren.
Type: | String[] |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Name
Gibt als Zeichenfolgenarray den Namen oder den Namen von Laufwerken an, die dieses Cmdlet im Vorgang abruft.
Geben Sie den Laufwerknamen oder buchstaben ohne Doppelpunkt (:
) ein.
Type: | String[] |
Position: | 0 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-PSProvider
Gibt als Zeichenfolgenarray den Windows PowerShell Anbieter an. Dieses Cmdlet ruft nur die Laufwerke ab, die von diesem Anbieter unterstützt werden. Geben Sie den Namen eines Anbieters ein, z. B. %%amp;quot;FileSystem%%amp;quot;, %%amp;quot;Registry%%amp;quot; oder %%amp;quot;Certificate%%amp;quot;.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Scope
Gibt den Bereich an, in dem dieses Cmdlet die Laufwerke abruft.
Zulässige Werte für diesen Parameter:
- Global
- Lokal
- Skript
- eine Zahl relativ zum aktuellen Bereich (0 bis zur Anzahl der Bereiche, wobei 0 der aktuelle Bereich ist und 1 der übergeordnete Bereich ist). Local ist der Standardwert.
Weitere Informationen finden Sie unter about_Scopes.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Eingaben
None
Objekte können nicht an dieses Cmdlet weitergereicht werden.
Ausgaben
Dieses Cmdlet gibt Objekte zurück, die die Laufwerke in der Sitzung darstellen.
Hinweise
- Dieses Cmdlet dient zum Arbeiten mit den Daten, die von jedem Anbieter verfügbar gemacht werden. Führen Sie die verfügbaren Anbieter in Ihrer Sitzung mithilfe des Cmdlets
Get-PSProvider
auf. Weitere Informationen finden Sie unter about_Providers. - Zugeordnete Netzwerklaufwerke, die mithilfe des Persist-Parameters des Cmdlets New-PSDrive erstellt werden, sind spezifisch für ein Benutzerkonto. Zugeordnete Netzwerklaufwerke, die Sie in Sitzungen erstellen, die mit der Option "Als Administrator ausführen" oder mit den Anmeldeinformationen eines anderen Benutzers gestartet werden, sind nicht in Sitzungen sichtbar, die ohne explizite Anmeldeinformationen oder mit den Anmeldeinformationen des aktuellen Benutzers gestartet werden.