Ruft die Windows PowerShell-Laufwerke in der aktuellen Sitzung ab.
Syntax
Get-PSDrive [-LiteralName] <string[]> [-PSProvider <string[]>] [-Scope <string>] [-UseTransaction] [<CommonParameters>] Get-PSDrive [[-Name] <string[]>] [-PSProvider <string[]>] [-Scope <string>] [-UseTransaction] [<CommonParameters>]
Beschreibung
Das Cmdlet "Get-PSDrive" ruft die Windows PowerShell-Laufwerke in der aktuellen Sitzung ab. Sie können ein bestimmtes Laufwerk oder alle Laufwerke in der Konsole abrufen.
Get-PSDrive ruft die folgenden Laufwerke ab:
- Logische Windows-Laufwerke auf dem Computer, einschließlich Netzwerkfreigaben zugeordnete Laufwerke.
- Von Windows PowerShell-Anbietern verfügbar gemachte Laufwerke (z. B. die Laufwerke "Certificate:", "Function:" und "Alias:") und die Laufwerke "HKLM:" und "HKCU:", die vom Windows PowerShell-Registry-Anbieter verfügbar gemacht werden.
- Mit New-PSDrive erstellte Laufwerke.
Get-PSDrive ruft keine in Windows zugeordneten Laufwerke ab, die nach dem Öffnen der Windows PowerShell-Konsole hinzugefügt oder erstellt werden.
Parameter
-LiteralName <string[]>
Gibt den Namen des Windows PowerShell-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.
|
Erforderlich? |
true |
|
Position? |
1 |
|
Standardwert |
|
|
Pipelineeingaben akzeptieren? |
true (ByPropertyName) |
|
Platzhalterzeichen akzeptieren? |
false |
-Name <string[]>
Ruft nur die angegebenen Laufwerke ab. Geben Sie den Laufwerknamen oder den Buchstaben ohne Doppelpunkt (:) ein.
|
Erforderlich? |
false |
|
Position? |
1 |
|
Standardwert |
|
|
Pipelineeingaben akzeptieren? |
true (ByPropertyName) |
|
Platzhalterzeichen akzeptieren? |
false |
-PSProvider <string[]>
Ruft nur die vom angegebenen Windows PowerShell-Anbieter unterstützten Laufwerke ab. Geben Sie den Namen eines Anbieters ein, z. B. "FileSystem", "Registry" oder "Certificate".
|
Erforderlich? |
false |
|
Position? |
named |
|
Standardwert |
|
|
Pipelineeingaben akzeptieren? |
true (ByPropertyName) |
|
Platzhalterzeichen akzeptieren? |
false |
-Scope <string>
Ruft nur Windows PowerShell-Laufwerke im angegebenen Bereich ab. Gültige Werte sind "global", "local", "script", oder eine Zahl in Bezug auf den aktuellen Bereich (0 bis zur Anzahl der Bereiche, wobei 0 der aktuelle Bereich und 1 der übergeordnete Bereich ist). Der Standardwert ist "local". Weitere Informationen finden Sie unter "about_Scopes".
|
Erforderlich? |
false |
|
Position? |
named |
|
Standardwert |
|
|
Pipelineeingaben akzeptieren? |
true (ByPropertyName) |
|
Platzhalterzeichen akzeptieren? |
false |
-UseTransaction
Schließt den Befehl in die aktive Transaktion ein. Dieser Parameter ist nur gültig, wenn eine Transaktion ausgeführt wird. Weitere Informationen finden Sie unter "about_Transactions".
|
Erforderlich? |
false |
|
Position? |
named |
|
Standardwert |
|
|
Pipelineeingaben akzeptieren? |
false |
|
Platzhalterzeichen akzeptieren? |
false |
<CommonParameters>
Dieses Cmdlet unterstützt die folgenden allgemeinen Parameter: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer und -OutVariable. Weitere Informationen finden Sie unter about_Commonparameters.
Eingaben und Ausgaben
Der Eingabetyp ist der Typ der Objekte, die über die Pipeline an das Cmdlet übergeben werden können. Der Rückgabetyp ist der Typ der Objekte, die das Cmdlet zurückgibt.
|
Eingaben |
None Objekte können nicht über die Pipeline an Get-PSDrive übergeben werden. |
|
Ausgaben |
System.Management.Automation.PSDriveInfo Get-PSDrive gibt Objekte zurück, die die Windows PowerShell-Laufwerke in der Sitzung darstellen. |
Hinweise
Das Cmdlet "Get-PSDrive" ist für die Verwendung mit Daten konzipiert, die von beliebigen Anbietern verfügbar gemacht werden. Um die in der Sitzung verfügbaren Anbieter aufzuführen, geben Sie "Get-PSProvider" ein. Weitere Informationen finden Sie unter "about_Providers".
Beispiel 1
C:\PS>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
X FileSystem X:\
Beschreibung
-----------
Dieser Befehl ruft die Windows PowerShell-Laufwerke in der aktuellen Sitzung ab.
Die Ausgabe zeigt die Festplatte ("C:") und das CD-ROM-Laufwerk ("D:") auf dem Computer an, die von den Windows PowerShell-Anbietern verfügbar gemachten Laufwerke ("Alias:", "Cert:", "Env:", "Function:", "HKCU:", "HKLM:" und "Variable:") und ein einer Netzwerkfreigabe zugeordnetes Laufwerk ("X:").
Beispiel 2
C:\PS>get-psdrive d Name Provider Root ---- -------- ---- D FileSystem D:\ Beschreibung ----------- Dieser Befehl zeigt das Laufwerk "D:" auf dem Computer an. Achten Sie darauf, dass nach dem Laufwerkbuchstaben kein Doppelpunkt folgt.
Beispiel 3
C:\PS>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 Beschreibung ----------- Dieser Befehl zeigt alle Laufwerke an, die vom Windows PowerShell-Anbieter FileSystem unterstützt werden. Dies schließt feste Laufwerke, logische Partitionen, zugeordnete Netzlaufwerke und Laufwerke ein, die Sie mit New-PSDrive erstellen und die Dateisystemlaufwerken zugeordnet sind. Dieses Beispiel veranschaulicht, dass bei mit New-PSDrive erstellten Laufwerken der Name des zugeordneten Speicherorts im Wert der Root-Eigenschaft enthalten ist. Bei Windows-Laufwerken ist nur der Stamm des Laufwerkbuchstabens vorhanden.
Beispiel 4
C:\PS>if (!(get-psdrive X)) {
new-psdrive -name X -psprovider Registry -root HKLM:\Network
}
else { write-host "The X: drive is already in use." }
Beschreibung
-----------
Dieser Befehl überprüft, ob das Laufwerk "X" bereits als Windows PowerShell-Laufwerkname verwendet wird. Wenn dies nicht der Fall ist, verwendet der Befehl das Cmdlet "New-PSDrive", um ein Windows PowerShell-Laufwerk zu erstellen, das dem Registrierungsschlüssel "HKLM:\Network" zugeordnet ist.
Beispiel 5
C:\PS>get-psdrive -provider filesystem
C:\PS> get-psdrive -provider filesystem
Name Provider Root
---- -------- ----
C FileSystem C:\
D FileSystem D:\
X FileSystem X:\
Y FileSystem \\Server01\Public
Z FileSystem C:\Windows\System32
C:\PS> net use
New connections will be remembered.
Status Local Remote Network
-------------------------------------------------------------------------------
X: \\Server01\Public Microsoft Windows Network
C:\PS> [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
C:\PS> 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
C:\PS> get-wmiobject win32_networkconnection
LocalName RemoteName
-------------- ------------
x: \\server01\public
Beschreibung
-----------
In diesem Beispiel werden die Typen von Dateisystemlaufwerken, die von Get-PSDrive angezeigt werden, mit den Typen verglichen, die mit anderen Methoden angezeigt werden. In diesem Beispiel werden unterschiedliche Möglichkeiten veranschaulicht, Laufwerke in Windows PowerShell anzuzeigen, und es wird erläutert, dass auf die mit New-PSDrive erstellten Laufwerke nur in Windows PowerShell zugegriffen werden kann.
Der erste Befehl ruft mit Get-PSDrive alle Dateisystemlaufwerke in der Windows PowerShell-Konsole ab. Dies umfasst die festen Laufwerke ("C:" und "D:"), das zugeordnete Netzlaufwerk ("X:") und zwei Windows PowerShell-Laufwerke ("Y:" und "Z:"), die mit New-PsDrive erstellt wurden.
Mit dem Befehl "net use", der zugeordnete Windows-Netzlaufwerke anzeigt, wird nur das Laufwerk "X" angezeigt. Mit New-PSDrive erstellte Laufwerke werden nicht angezeigt. Es wird angezeigt, dass das Laufwerk "X:" auch "Server01\Public" 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 "X:", er ruft jedoch nicht die von New-PSDrive erstellten Laufwerke ab.
Der vierte Befehl zeigt mit dem Cmdlet "Get-WmiObject" die Instanzen der Win32_LogicalDisk-Klasse an. Er gibt die Laufwerke "C:", "D:" und "X:" zurück, jedoch nicht die von New-PSDrive erstellten Laufwerke.
Der letzte Befehl zeigt mit dem Cmdlet "Get-WmiObject" die Instanzen der Win32_NetworkConnection-Klasse an. Wie bei "net use" wird nur das Laufwerk "X:" zurückgegeben.
Siehe auch