Erstellt in der aktuellen Sitzung ein Windows PowerShell-Laufwerk. (New-PSDrive)
NAMENew-PSDriveÜBERSICHTErstellt in der aktuellen Sitzung ein Windows PowerShell-Laufwerk.SYNTAXNew-PSDrive [-Name] <string> [-PSProvider] <string> [-Root] <string> [-Credential <PSCredential>] [-Description <string>] [-Scope <string>] [-Confirm] [-WhatIf] [-UseTransaction] [<CommonParameters>]BESCHREIBUNGDas Cmdlet "New-PSDrive" erstellt ein Windows PowerShell-Laufwerk, das einem Speicherort im Datenspeicher zugeordnet wird, z. B. einem Netzlaufwerk, einem Verzeichnis auf dem lokalen Computer oder einem Registrierungsschlüssel. Sie können mit den erstellten Windows PowerShell-Laufwerken auf Daten im zugeordneten Datenspeicher zugreifen wie auf jedes andere zugeordnete Laufwerk. Sie können Speicherorte (mit "set-location", "cd" oder "chdir") in das Laufwerk ändern und (mit "get-item", "get-childitem" oder "dir") auf den Inhalt des Laufwerks zugreifen. Die Windows PowerShell-Laufwerke sind jedoch nur für Windows PowerShell verfügbar. Es ist nicht möglich, mit Windows-Explorer, der Windows-Verwaltungsinstrumentation (WMI), dem Component Object Model (COM) bzw. Microsoft .NET Framework oder mit Tools wie Net Use darauf zuzugreifen. Windows PowerShell-Laufwerke sind nur in der aktuellen Windows PowerShell-Sitzung vorhanden. Um das Laufwerk dauerhaft verfügbar zu machen, können Sie die Sitzung, der Sie das Laufwerk hinzugefügt haben, exportieren oder den Befehl "New-PSDrive" im Windows PowerShell-Profil speichern. Verwenden Sie das Cmdlet "Remove-PSDrive", um ein mit New-PSDrive erstelltes Laufwerk zu löschen.PARAMETER-Credential <PSCredential> Gibt ein Benutzerkonto an, das über die Berechtigung zum Ausführen dieser Aktion verfügt. Der Standardwert ist der aktuelle Benutzer. Geben Sie einen Benutzernamen ein, z. B. "User01" oder "Domain01\User01". Oder geben Sie ein PSCredential-Objekt ein, z. B. ein vom Cmdlet "Get-Credential" generiertes Objekt. Wenn Sie einen Benutzernamen eingeben, werden Sie zur Eingabe eines Kennworts aufgefordert. Dieser Parameter wird nicht von mit Windows PowerShell installierten Anbietern unterstützt. Erforderlich? false Position? named Standardwert Pipelineeingaben akzeptieren?true (ByPropertyName) Platzhalterzeichen akzeptieren?false -Description <string> Gibt eine kurze Textbeschreibung des Laufwerks an. Geben Sie eine beliebige Zeichenfolge ein. Wenn Sie die Beschreibungen aller Windows PowerShell-Laufwerke auf dem System anzeigen möchten, geben Sie Folgendes ein: "get-psdrive | format name, description". Wenn Sie die Beschreibung eines bestimmten Windows PowerShell-Laufwerks anzeigen möchten, geben Sie Folgendes ein: "(get-psdrive <Laufwerkname>).description". Erforderlich? false Position? named Standardwert Pipelineeingaben akzeptieren?true (ByPropertyName) Platzhalterzeichen akzeptieren?false -Name <string> Gibt einen Namen für das neue Laufwerk an. Sie können eine beliebige gültige Zeichenfolge als Namen verwenden. Sie sind nicht auf Laufwerkbuchstaben beschränkt. Bei Laufwerknamen in Windows PowerShell wird die Groß-/Kleinschreibung beachtet. Erforderlich? true Position? 1 Standardwert Pipelineeingaben akzeptieren?true (ByPropertyName) Platzhalterzeichen akzeptieren?false -PSProvider <string> Gibt den Windows PowerShell-Anbieter an, der Laufwerke dieses Typs unterstützt. Wenn die Windows PowerShell-Laufwerke z. B. einer Netzwerkfreigabe oder einem Dateisystemverzeichnis zugeordnet werden, lautet der Windows PowerShell-Anbieter "FileSystem". Wenn das Windows PowerShell-Laufwerk einem Registrierungsschlüssel zugeordnet wird, lautet der Anbieter "Registry". Geben Sie "get-psprovider" ein, um eine Liste der Anbieter in der Windows PowerShell-Sitzung anzuzeigen. Erforderlich? true Position? 2 Standardwert Pipelineeingaben akzeptieren?true (ByPropertyName) Platzhalterzeichen akzeptieren?false -Root <string> Gibt den Speicherort im Datenspeicher an, dem das Windows PowerShell-Laufwerk zugeordnet ist. Geben Sie z. B. eine Netzwerkfreigabe (wie "\\Server01\Public"), ein lokales Verzeichnis (wie "C:\Programme") oder einen Registrierungsschlüssel an (wie "HKLM:\Software\Microsoft"). Erforderlich? true Position? 3 Standardwert Pipelineeingaben akzeptieren?true (ByPropertyName) Platzhalterzeichen akzeptieren?false -Scope <string> Gibt einen Bereich für das Laufwerk an. 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 -Confirm [<SwitchParameter>] Fordert Sie vor der Ausführung des Befehls zur Bestätigung auf. Erforderlich? false Position? named Standardwert Pipelineeingaben akzeptieren?false Platzhalterzeichen akzeptieren?false -WhatIf [<SwitchParameter>] Beschreibt die Auswirkungen einer Ausführung des Befehls, ohne den Befehl tatsächlich auszuführen. Erforderlich? false Position? named Standardwert Pipelineeingaben akzeptieren?false Platzhalterzeichen akzeptieren?false -UseTransaction [<SwitchParameter>] 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 folgende allgemeine Parameter: "Verbose", "Debug", "ErrorAction", "ErrorVariable", "WarningAction", "WarningVariable", "OutBuffer" und "OutVariable". Weitere Informationen erhalten Sie mit dem Befehl "get-help about_commonparameters".EINGABENKeiner Eingaben können nicht über die Pipeline an dieses Cmdlet übergeben werden.AUSGABENSystem.Management.Automation.PSDriveInfoHINWEISEDas Cmdlet "New-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".Beispiele
BEISPIEL 1C:\PS>new-psdrive -name P -psprovider FileSystem -root \\Server01\Public Name Provider Root ---- -------- ---- P FileSystem \\Server01\Public Beschreibung ----------- Mit diesem Befehl wird ein Windows PowerShell-Laufwerk erstellt, dessen Funktionen den Funktionen eines zugeordneten Netzlaufwerks in Windows entsprechen. Der Befehl erstellt das Windows PowerShell-Laufwerk "P:", das der Netzwerkfreigabe "\\Server01\Public" zugeordnet wird. Dabei wird mit dem Name-Parameter ein Name für das Laufwerk, mit dem PSProvider-Parameter der Windows PowerShell-FileSystem-Anbieter und mit dem Root-Parameter die Netzwerkfreigabe angegeben. Nach Abschluss des Befehls wird der Inhalt der Freigabe "\\Server01\Public" auf dem Laufwerk "P:" angezeigt. Geben Sie zum Anzeigen "dir p:" ein.BEISPIEL 2C:\PS>new-psdrive -name MyDocs -psprovider FileSystem -root "C:\Documents and Settings\User01\My Documents" -Description "Maps to my My Documents folder." Name Provider Root ---- -------- ---- MyDocs FileSystem C:\Documents and Settings\User01\My Documents Beschreibung ----------- Mit diesem Befehl wird ein Windows PowerShell-Laufwerk erstellt, das schnellen Zugriff auf ein lokales Verzeichnis ermöglicht. Es wird ein Laufwerk mit dem Namen "MyDocs:" erstellt, das dem Verzeichnis "C:\Documents und Settings\User01\My Documents" auf dem lokalen Computer zugeordnet wird. Mit dem Name-Parameter wird ein Name für das Laufwerk angegeben, mit dem PSProvider-Parameter wird der Windows PowerShell-FileSystem-Anbieter angegeben, und mit dem Root-Parameter wird der Pfad zum Ordner "Eigene Dateien" angegeben. Mit dem Description-Parameter wird eine Beschreibung des Laufwerks erstellt. Nach Abschluss des Befehls wird der Inhalt des Ordners "My Documents" auf dem Laufwerk "MyDocs:" angezeigt. Geben Sie zum Anzeigen "dir mydocs:" ein.BEISPIEL 3C:\PS>new-psdrive -name MyCompany -psprovider Registry -root HKLM:\Software\MyCompany Name Provider Root ---- -------- ---- MyCompany Registry HKEY_LOCAL_MACHINE\Software\MyCo... Beschreibung ----------- Mit diesem Befehl wird ein Windows PowerShell-Laufwerk erstellt, das schnellen Zugriff auf einen häufig überprüften Registrierungsschlüssel ermöglicht. Der Befehl erstellt das Laufwerk "MyCompany", das dem Registrierungsschlüssel "HKLM\Software\MyCompany" zugeordnet wird. Mit dem Name-Parameter wird ein Name für das Laufwerk angegeben, mit dem PSProvider-Parameter wird der Windows PowerShell-Registry-Anbieter angegeben, und mit dem Root-Parameter wird der Registrierungsschlüssel angegeben. Nach Abschluss des Befehls wird der Inhalt des Schlüssels "MyCompany" auf dem Laufwerk "MyCompany" angezeigt. Geben Sie zum Anzeigen "dir MyCompany:" ein.BEISPIEL 4C:\PS>new-psdrive -name PsDrive -psprovider FileSystem -root \\Server01\Public C:\PS> $drive = new-object -com wscript.network C:\PS> $drive.MapNetworkDrive("X:", "\\Server01\Public") C PS:\> get-psdrive public, x Name Provider Root ---- -------- ---- PsDrive FileSystem \\Server01\public X FileSystem X:\ C:\PS>get-psdrive psdrive, x | get-member TypeName: System.Management.Automation.PSDriveInfo Name MemberType Definition ---- ---------- ---------- CompareTo Method System.Int32 CompareTo(PSDriveInfo drive), Equals Method System.Boolean Equals(Object obj), GetHashCode Method System.Int32 GetHashCode() ... C:\PS> net use Status Local Remote Network --------------------------------------------------------------------------- X: \\server01\public Microsoft Windows Network C:\PS> get-wmiobject win32_logicaldisk | ft deviceid deviceid -------- C: D: X: C:\PS> get-wmiobject win32_networkconnection LocalName RemoteName ConnectionState Status --------- ---------- --------------- ------ X: \\products\public Disconnected Unavailable Beschreibung ----------- In diesem Beispiel wird der Unterschied zwischen einem Windows-Laufwerk, das einer Netzwerkfreigabe zugeordnet ist, und einem Windows PowerShell-Laufwerk veranschaulicht, das der gleichen Netzwerkfreigabe zugeordnet ist. Im ersten Befehl wird mit dem Cmdlet "New-PSDrive" das Windows PowerShell-Laufwerk "PSDrive:" erstellt, das der Netzwerkfreigabe "\\Server01\Public" zugeordnet wird. Im zweiten Satz von Befehlen wird mit dem Cmdlet "New-Object" ein Wscript.Network-COM-Objekt erstellt. Danach wird mit der MapNetworkDrive-Methode die Netzwerkfreigabe "\\Server01\Public" dem Laufwerk "X:" auf dem lokalen Computer zugeordnet. Nun können die beiden Laufwerke betrachtet werden. Bei Verwendung des Laufwerkbefehls "Get-PSDrive" scheinen die beiden Laufwerke identisch zu sein, obwohl der Netzwerkfreigabename nur im Stamm des Laufwerks "PSDrive:" angezeigt wird. Durch das Senden der Laufwerksobjekte an Get-Member wird gezeigt, dass sie den gleichen Objekttyp aufweisen: System.Management.Automation.PSDriveInfo. Mit dem Befehl "net use", dem Befehl "Get-WmiObject" für die Win32_LogicalDisk-Klasse und dem Befehl "Get-WmiObject" für die Win32_NetworkConnection-Klasse wird jedoch nur das Laufwerk "X:" gefunden, das mithilfe des Wscript.Network-Objekts erstellt wurde. Das liegt daran, dass Windows PowerShell-Laufwerke nur für Windows PowerShell verfügbar sind. Wenn Sie die Windows PowerShell-Sitzung schließen und dann eine neue Sitzung öffnen, wird das Laufwerk "PSDrive:" nicht mehr angezeigt, während Laufwerk "X:" weiterhin vorhanden ist. Wenn Sie entscheiden, mit welcher Methode Netzlaufwerke zugeordnet werden sollen, berücksichtigen Sie daher, wie das Laufwerk verwendet werden soll, ob es beibehalten werden muss und ob das Laufwerk für andere Windows-Features sichtbar sein muss. VERWANDTE LINKS Online version: http://go.microsoft.com/fwlink/?LinkID=113357 (möglicherweise auf Englisch) about_Providers Get-PSDrive Remove-PSDrive C:\Windows>powershell get-help Remove-PSDrive -full
Microsoft Windows [Version 10.0.19045.3693]
Copyright (c) 2023 Microsoft Corporation.
ColorConsole [Version 3.7.1000] PowerShell 2.0-Export
