New-PSDrive
Erstellt temporäre und persistente Laufwerke, die einem Speicherort in einem Elementdatenspeicher zugeordnet sind.
Syntax
All
New-PSDrive
[-Name] <String>
[-PSProvider] <String>
[-Root] <String>
[-Description <String>]
[-Scope <String>]
[-Persist]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Beschreibung
Das Cmdlet New-PSDrive erstellt temporäre und persistente Laufwerke, die einem Speicherort in einem Datenspeicher zugeordnet oder zugeordnet sind, z. B. einem Netzlaufwerk, einem Verzeichnis auf dem lokalen Computer oder einem Registrierungsschlüssel sowie persistenten Windows zugeordneten Netzwerklaufwerken, die einem Dateisystemspeicherort auf einem Remotecomputer zugeordnet sind.
Temporäre Laufwerke sind nur in der aktuellen PowerShell-Sitzung und in Sitzungen vorhanden, die Sie in der aktuellen Sitzung erstellen. Sie können einen beliebigen Namen haben, der in PowerShell gültig ist und jeder lokalen oder Remoteressource zugeordnet werden kann. Sie können temporäre PowerShell-Laufwerke verwenden, um auf Daten im zugeordneten Datenspeicher zuzugreifen, genau wie bei jedem zugeordneten Netzlaufwerk. Sie können Speicherorte in das Laufwerk ändern, indem Sie den Inhalt des Laufwerks verwenden Set-LocationGet-Item oder Get-ChildItemdarauf zugreifen.
Da temporäre Laufwerke nur für PowerShell bekannt sind, können Sie nicht über den Datei-Explorer, Windows Verwaltungsinstrumentation (WMI), das Component Object Model (COM), Microsoft .NET Framework oder mit Tools wie net use darauf zugreifen.
Die folgenden Features wurden in PowerShell 3.0 hinzugefügt New-PSDrive :
- Zugeordnete Netzlaufwerke. Sie können den Parameter Persist von
New-PSDriveverwenden, um Windows zugeordneten Netzlaufwerke zu erstellen. Im Gegensatz zu temporären PowerShell-Laufwerken sind Windows zugeordneten Netzwerklaufwerke nicht sitzungsspezifisch. Sie werden in Windows gespeichert und können mithilfe standardmäßiger Windows Tools wie Datei-Explorer und net-Verwendung verwaltet werden. Zugeordnete Netzwerklaufwerke müssen über einen Laufwerkbuchstabennamen verfügen und an einen Remotedateisystemspeicherort angeschlossen sein. Wenn Ihr Befehl lokal festgelegt ist, wird der Parameter "Persist " nicht beibehalten, wenn der Bereich eines PSDrive über den Bereich hinausgeht, in dem der Befehl ausgeführt wird. Wenn Sie innerhalb eines Skripts ausgeführtNew-PSDrivewerden und das Laufwerk unbegrenzt beibehalten werden soll, müssen Sie das Skript mit Punktquelle erstellen. Um optimale Ergebnisse zu erzielen, müssen Sie erzwingen, dass ein neues Laufwerk unbegrenzt beibehalten wird, fügen Sie dem Befehl den Parameter "Scope" hinzu, und legen Sie den Wert auf "Global" fest. Weitere Informationen zur Dot-Sourcing finden Sie unter about_Scripts. - Externe Laufwerke. Wenn ein externes Laufwerk mit dem Computer verbunden ist, fügt PowerShell automatisch ein PSDrive zum Dateisystem hinzu, das das neue Laufwerk darstellt. PowerShell muss nicht neu gestartet werden. Wenn ein externes Laufwerk vom Computer getrennt wird, löscht PowerShell automatisch das PSDrive , das das entfernte Laufwerk darstellt.
- Anmeldeinformationen für UNC-Pfade (Universal Naming Convention).
Wenn der Wert des Stammparameters ein UNC-Pfad ist, z \\Server\Share. B. die im Wert des Parameters " Credential " angegebenen Anmeldeinformationen, wird zum Erstellen des PSDrive verwendet. Andernfalls sind Anmeldeinformationen beim Erstellen neuer Dateisystemlaufwerke nicht wirksam.
Einige Codebeispiele verwenden splatting, um die Zeilenlänge zu reduzieren und die Lesbarkeit zu verbessern. Weitere Informationen finden Sie unter about_Splatting.
Note
Sofern Sie den Parameter Scope nicht verwenden, werden PSDrives im Bereich erstellt, in dem der New-PSDrive Befehl ausgeführt wird.
Beispiele
Beispiel 1: Erstellen eines temporären Laufwerks, das einer Netzwerkfreigabe zugeordnet ist
In diesem Beispiel wird ein temporäres PowerShell-Laufwerk erstellt, das einer Netzwerkfreigabe zugeordnet ist.
New-PSDrive -Name "Public" -PSProvider "FileSystem" -Root "\\Server01\Public"
Name Provider Root
---- -------- ----
Public FileSystem \\Server01\Public
New-PSDrive verwendet den Parameter Name , um das PowerShell-Laufwerk namens Public und den PSProvider-Parameter anzugeben, um den PowerShell-Anbieter FileSystem anzugeben. Der Root-Parameter gibt den UNC-Pfad der Netzwerkfreigabe an.
So zeigen Sie den Inhalt aus einer PowerShell-Sitzung an: Get-ChildItem -Path Public:
Beispiel 2: Erstellen eines temporären Laufwerks, das einem lokalen Verzeichnis zugeordnet ist
In diesem Beispiel wird ein temporäres PowerShell-Laufwerk erstellt, das Zugriff auf ein Verzeichnis auf dem lokalen Computer ermöglicht.
$parameters = @{
Name = "MyDocs"
PSProvider = "FileSystem"
Root = "C:\Users\User01\Documents"
Description = "Maps to my My Documents folder."
}
New-PSDrive @parameters
Name Provider Root
---- -------- ----
MyDocs FileSystem C:\Users\User01\Documents
Durch splatting werden die Parameterschlüssel und -werte erstellt. Der Parameter Name gibt den Laufwerknamen MyDocs an. Der PARAMETER "PSProvider " gibt den PowerShell-Anbieter FileSystem an.
Stamm gibt das Verzeichnis des lokalen Computers an. Der Description-Parameter beschreibt den Zweck des Laufwerks.
New-PSDrive verwendet die splatted-Parameter, um das MyDocs Laufwerk zu erstellen.
So zeigen Sie den Inhalt aus einer PowerShell-Sitzung an: Get-ChildItem -Path MyDocs:
Beispiel 3: Erstellen eines temporären Laufwerks für einen Registrierungsschlüssel
In diesem Beispiel wird ein temporäres PowerShell-Laufwerk erstellt, das Zugriff auf einen Registrierungsschlüssel ermöglicht. Es erstellt ein Laufwerk mit dem Namen "MyCompany", das dem HKLM:\Software\MyCompany Registrierungsschlüssel zugeordnet ist.
New-PSDrive -Name "MyCompany" -PSProvider "Registry" -Root "HKLM:\Software\MyCompany"
Name Provider Root
---- -------- ----
MyCompany Registry HKLM:\Software\MyCompany
New-PSDrive verwendet den Parameter Name , um das PowerShell-Laufwerk namens MyCompany und den PSProvider-Parameter anzugeben, um den PowerShell-Anbieter Registry anzugeben. Der Root-Parameter gibt den Registrierungsspeicherort an.
So zeigen Sie den Inhalt aus einer PowerShell-Sitzung an: Get-ChildItem -Path MyCompany:
Beispiel 4: Erstellen eines dauerhaft zugeordneten Netzlaufwerks mit Anmeldeinformationen
In diesem Beispiel wird ein Netzlaufwerk zugeordnet, das mit den Anmeldeinformationen eines Domänendienstkontos authentifiziert wird. Weitere Informationen zum PSCredential-Objekt , das Anmeldeinformationen speichert und wie Kennwörter als SecureString gespeichert werden, finden Sie in der Beschreibung des Parameters "Credential ".
$cred = Get-Credential -Credential Contoso\ServiceAccount
New-PSDrive -Name "S" -Root "\\Server01\Scripts" -Persist -PSProvider "FileSystem" -Credential $cred
Net Use
Status Local Remote Network
---------------------------------------------------------
OK S: \\Server01\Scripts Microsoft Windows Network
Note
Wenn Sie den obigen Codeausschnitt in einem Skript verwenden, legen Sie den Parameterwert "Scope " auf "Global" fest, um sicherzustellen, dass das Laufwerk außerhalb des aktuellen Bereichs beibehalten wird.
Die $cred Variable speichert ein PSCredential-Objekt , das die Anmeldeinformationen des Dienstkontos enthält.
Get-Credential fordert Sie auf, das Kennwort einzugeben, das in einem SecureString gespeichert ist.
New-PSDrive erstellt das zugeordnete Netzlaufwerk mithilfe mehrerer Parameter.
Name gibt den S Laufwerkbuchstaben an, der Windows akzeptiert. und Root definiert \\Server01\Scripts den Speicherort auf einem Remotecomputer.
Persist erstellt ein Windows zugeordnetes Netzlaufwerk, das auf dem lokalen Computer gespeichert ist.
PSProvider gibt den FileSystem Anbieter an.
Anmeldeinformationen verwenden die $cred Variable, um die Anmeldeinformationen des Dienstkontos für die Authentifizierung abzurufen.
Das zugeordnete Laufwerk kann auf dem lokalen Computer in PowerShell-Sitzungen, Dem Datei-Explorer und mit Tools wie der Net Use angezeigt werden. So zeigen Sie den Inhalt aus einer PowerShell-Sitzung an: Get-ChildItem -Path S:
Beispiel 5: Erstellen dauerhafter und temporärer Laufwerke
In diesem Beispiel wird der Unterschied zwischen einem dauerhaft zugeordneten Netzlaufwerk und einem temporären PowerShell-Laufwerk gezeigt, das derselben Netzwerkfreigabe zugeordnet ist.
Wenn Sie die PowerShell-Sitzung schließen und dann eine neue Sitzung öffnen, ist die temporäre PSDrive: Sitzung nicht verfügbar, aber das dauerhafte X: Laufwerk ist verfügbar. Berücksichtigen Sie bei der Entscheidung, welche Methode zum Zuordnen von Netzlaufwerken verwendet werden soll, wie Sie das Laufwerk verwenden. Beispielsweise, ob es dauerhaft sein muss und ob das Laufwerk für andere Windows Features sichtbar sein muss.
# Create a temporary PowerShell drive called PSDrive:
# that's mapped to the \\Server01\Public network share.
New-PSDrive -Name "PSDrive" -PSProvider "FileSystem" -Root "\\Server01\Public"
# Use the Persist parameter of New-PSDrive to create the X: mapped network drive,
# which is also mapped to the \\Server01\Public network share.
New-PSDrive -Persist -Name "X" -PSProvider "FileSystem" -Root "\\Server01\Public"
# Now, you can use the Get-PSDrive drive cmdlet to examine the two drives.
# The drives appear to be the same, although the network share name appears only
# in the root of the PSDrive: drive.
Get-PSDrive -Name "PSDrive", "X"
Name Provider Root
---- -------- ----
PSDrive FileSystem \\Server01\public
X FileSystem X:\
# Get-Member cmdlet shows that the drives have the same object type,
# System.Management.Automation.PSDriveInfo.
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()
...
# Net Use and Get-CimInstance for the Win32_LogicalDisk class,
# and Win32_NetworkConnection class find only the persistent X: drive.
# PowerShell temporary drives are known only to PowerShell.
Net Use
Get-CimInstance Win32_LogicalDisk | Format-Table -Property DeviceID
Get-CimInstance Win32_NetworkConnection
Status Local Remote Network
--------------------------------------------------------
OK X: \\contoso-pc\data Microsoft Windows Network
deviceid
--------
C:
D:
X:
LocalName RemoteName ConnectionState Status
--------- ---------- --------------- ------
X: \\products\public Disconnected Unavailable
Beispiel 6: Erstellen eines beständigen Laufwerks in einem Skript
PSDrives werden im Bereich erstellt, in dem der New-PSDrive Befehl ausgeführt wird. Wenn der Befehl innerhalb eines Skripts ausgeführt wird, ist die Laufwerkzuordnung lokal für das Skript. Wenn das Skript beendet wird, ist das Laufwerk nicht mehr verfügbar.
New-PSDrive -Persist -Name "X" -PSProvider "FileSystem" -Root "\\Server01\Public" -Scope Global
Um sicherzustellen, dass das Laufwerk außerhalb des Skripts verfügbar ist, müssen Sie den Parameter Scope verwenden, um das Laufwerk im globalen Bereich zu erstellen.
Parameter
-Confirm
Fordert Sie zur Bestätigung auf, bevor Sie das Cmdlet ausführen.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | False |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
| Aliase: | Cf |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Credential
Gibt ein Benutzerkonto an, das über die Berechtigung zum Ausführen dieser Aktion verfügt. Die Standardeinstellung ist der aktuelle Benutzer.
Da PowerShell 3.0, wenn der Wert des Root-Parameters ein UNC-Pfad ist, können Sie Anmeldeinformationen zum Erstellen von Dateisystemlaufwerken verwenden.
Geben Sie einen Benutzernamen ein, z. B. User01 oder Domain01\User01, oder geben Sie ein PSCredential-Objekt ein, das vom cmdlet Get-Credential generiert wird. Wenn Sie einen Benutzernamen eingeben, werden Sie aufgefordert, das Kennwort einzugeben.
Anmeldeinformationen werden in einem PSCredential-Objekt gespeichert, und das Kennwort wird als SecureString-gespeichert.
Note
Weitere Informationen zu SecureString Datenschutz finden Sie unter Wie sicher ist SecureString?.
Parametereigenschaften
| Typ: | PSCredential |
| Standardwert: | Current user |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | False |
-Description
Gibt eine kurze Textbeschreibung des Laufwerks an. Geben Sie eine beliebige Zeichenfolge ein.
Um die Beschreibungen aller Laufwerke der Sitzung anzuzeigen, Get-PSDrive | Format-Table Name, Description
Um die Beschreibung eines bestimmten Laufwerks anzuzeigen, geben Sie folgendes ein (Get-PSDrive <DriveName>).Description.
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | False |
-Name
Gibt einen Namen für das neue Laufwerk an. Verwenden Sie für persistent zugeordnete Netzlaufwerke einen Laufwerkbuchstaben. Bei temporären PowerShell-Laufwerken sind Sie nicht auf Laufwerkbuchstaben beschränkt, verwenden Sie eine gültige Zeichenfolge.
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | 0 |
| Obligatorisch.: | True |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | False |
-Persist
Gibt an, dass dieses Cmdlet ein Windows zugeordnetes Netzlaufwerk erstellt. Der Parameter Persist ist nur für Windows verfügbar.
Zugeordnete Netzlaufwerke werden auf dem lokalen Computer in Windows gespeichert. Sie sind persistent, nicht sitzungsspezifisch und können im Datei-Explorer und anderen Tools angezeigt und verwaltet werden.
Wenn Sie den Befehl lokal festlegen, ohne Dot-Sourcing, behält der Persist-Parameter die Erstellung eines PSDrive über den Bereich hinaus, in dem Sie den Befehl ausführen. Wenn Sie innerhalb eines Skripts ausgeführt werden New-PSDrive und das neue Laufwerk unbegrenzt beibehalten werden soll, müssen Sie das Skript mit Punktquelle erstellen. Um optimale Ergebnisse zu erzielen, geben Sie global als Wert des Bereichsparameters an, um zu erzwingen, dass ein neues Laufwerk beibehalten wird, und fügen Sie "Persist" in den Befehl ein.
Der Name des Laufwerks muss ein Buchstabe sein, z D . B. oder E. Der Wert des Root-Parameters muss ein UNC-Pfad eines anderen Computers sein. Der Wert des PSProvider-Parameters muss sein FileSystem.
Verwenden Sie das Cmdlet Remove-PSDrive, um ein zugeordnetes Windows Netzlaufwerk zu trennen. Wenn Sie ein Windows zugeordneten Netzlaufwerk trennen, wird die Zuordnung endgültig vom Computer gelöscht, nicht nur aus der aktuellen Sitzung.
Zugeordnete Netzwerklaufwerke sind spezifisch für ein Benutzerkonto. Zugeordnete Laufwerke, die in Sitzungen mit erhöhten Rechten oder Sitzungen mit den Anmeldeinformationen eines anderen Benutzers erstellt wurden, sind in Sitzungen, die mit unterschiedlichen Anmeldeinformationen begonnen haben, nicht sichtbar.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | False |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | False |
-PSProvider
Gibt den PowerShell-Anbieter an, der Laufwerke dieser Art unterstützt.
Wenn das Laufwerk beispielsweise einer Netzwerkfreigabe oder einem Dateisystemverzeichnis zugeordnet ist, lautet FileSystemder PowerShell-Anbieter . Wenn das Laufwerk einem Registrierungsschlüssel zugeordnet ist, lautet Registryder Anbieter .
Temporäre PowerShell-Laufwerke können jedem Beliebigen PowerShell-Anbieter zugeordnet werden. Zugeordnete Netzwerklaufwerke können nur dem FileSystem Anbieter zugeordnet werden.
Verwenden Sie das Get-PSProvider Cmdlet, um eine Liste der Anbieter in Ihrer PowerShell-Sitzung anzuzeigen.
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | 1 |
| Obligatorisch.: | True |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | False |
-Root
Gibt den Datenspeicherort an, dem ein PowerShell-Laufwerk zugeordnet ist.
Geben Sie beispielsweise eine Netzwerkfreigabe an, z. B. \\Server01\Public, ein lokales Verzeichnis, z. B. C:\Program Files oder einen Registrierungsschlüssel, z. B. HKLM:\Software\Microsoft.
Temporäre PowerShell-Laufwerke können einem lokalen oder Remotespeicherort auf jedem unterstützten Anbieterlaufwerk zugeordnet werden. Zugeordnete Netzwerklaufwerke können nur einem Dateisystemspeicherort auf einem Remotecomputer zugeordnet werden.
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | 2 |
| Obligatorisch.: | True |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | False |
-Scope
Gibt einen Bereich für das Laufwerk an. Die zulässigen Werte für diesen Parameter sind: Global, Lokal und Script oder eine Zahl relativ zum aktuellen Bereich. Bereiche nummer 0 bis zur Anzahl der Bereiche. Die aktuelle Bereichsnummer ist 0, und das übergeordnete Element ist 1. Weitere Informationen finden Sie unter about_Scopes.
Parametereigenschaften
| Typ: | String |
| Standardwert: | Local |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | False |
-WhatIf
Zeigt, was passiert, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | False |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
| Aliase: | Wi |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
CommonParameters
Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.
Eingaben
None
Objekte können nicht an dieses Cmdlet weitergeleitet werden.
Ausgaben
PSDriveInfo
Dieses Cmdlet gibt ein PSDriveInfo-Objekt zurück, das das erstellte Laufwerk darstellt.
Hinweise
PowerShell enthält die folgenden Aliase für Get-PSDrive:
- Alle Plattformen:
ndr
- Fenster:
mount
New-PSDrive ist für die Arbeit mit den daten konzipiert, die von jedem Anbieter verfügbar gemacht werden. Um die in Ihrer Sitzung verfügbaren Anbieter auflisten zu können, verwenden Sie Get-PSProvider. Weitere Informationen zu Anbietern finden Sie unter about_Providers.
Zugeordnete Netzwerklaufwerke sind spezifisch für ein Benutzerkonto. Zugeordnete Laufwerke, die in Sitzungen mit erhöhten Rechten oder Sitzungen mit den Anmeldeinformationen eines anderen Benutzers erstellt wurden, sind in Sitzungen, die mit unterschiedlichen Anmeldeinformationen begonnen haben, nicht sichtbar.
