Zuordnen eines SMB-Laufwerks mit PowerShell

Um über einen Laufwerksbuchstaben auf eine Windows-Dateifreigabe zuzugreifen, ordnen Sie ihren UNC-Pfad (zum Beispiel \\FileServer\SharedFolder) mit dem PowerShell-Cmdlet New-SMBMapping oder dem Befehl net use zu. Ersetzen Sie in den Beispielen Server, Freigabe und Laufwerksbuchstaben durch die Werte Ihrer Netzwerkadministration. SMB ist das Protokoll für die Dateifreigabe; durch die Zuordnung wird ein freigegebener Netzwerkpfad über einen lokalen Laufwerkspfad verfügbar.

Eine SMB-Freigabe mit New-SMBMapping zuordnen

In PowerShell ordnet New-SMBMapping einen lokalen Laufwerkspfad einer Remotefreigabe zu. LocalPath steht für den Laufwerksbuchstaben, etwa Z:, und RemotePath für den UNC-Pfad der Freigabe. Ein typischer Befehl lautet New-SMBMapping -LocalPath Z: -RemotePath \\ServerName\SharedFolder. Führen Sie ihn in einer Windows-PowerShell-Sitzung aus, in der das Cmdlet verfügbar ist, und verwenden Sie einen Freigabepfad sowie Berechtigungen, die in Ihrer Umgebung gültig sind.

Das folgende kurze Beispiel gibt mit den Beispielwerten eine Befehlsvorschau aus. Es stellt keine Verbindung zu einem Server her. Kopieren Sie den angezeigten Befehl in eine geeignete Windows-PowerShell-Sitzung, nachdem Sie die Platzhalter ersetzt haben.

Führen Sie dieses Beispiel aus. Der Code und die darin angezeigten Bezeichnungen oder Ausgaben bleiben auf Englisch:

$drive = 'Z:'
$share = '\\ServerName\SharedFolder'
"New-SMBMapping -LocalPath $drive -RemotePath '$share'"

New-SMBMapping -LocalPath Z: -RemotePath '\\ServerName\SharedFolder'

Die Vorschau zeigt Laufwerksbuchstaben und UNC-Pfad zusammen an, damit Sie die Werte vor dem Ausführen des Zuordnungsbefehls prüfen können. Für eine tatsächliche Verbindung führen Sie den Befehl selbst aus, nicht das Vorschau-Skript.

Eine SMB-Freigabe mit net use zuordnen

net use ist eine Windows-Befehlszeilenalternative zum Erstellen und Anzeigen von Netzwerkverbindungen. Mit net use F: \\FS01\c$ wird beispielsweise die Freigabe unter \\FS01\c$ dem Laufwerk F: zugeordnet. Das $ ist hier Teil des Freigabenamens; für administrative Freigaben können andere Berechtigungen erforderlich sein als für gewöhnliche Freigaben.

Mit net use * \\FS01\SharedFolder können Sie Windows auch einen verfügbaren Laufwerksbuchstaben auswählen lassen. Das ist praktisch, wenn ein bestimmter Buchstabe keine Rolle spielt. Notieren Sie sich jedoch, welchen Buchstaben Windows zuweist, damit Sie später auf die Zuordnung verweisen können. Um zu vermeiden, dass ein Kennwort im Befehlsverlauf oder in Prozessdetails offengelegt wird, hängen Sie kein Klartextkennwort an den Befehl an. Falls eine Authentifizierung erforderlich ist, verwenden Sie das in Ihrer Organisation zugelassene Verfahren für Anmeldeinformationen und beachten Sie die Vorgaben für die interaktive Eingabeaufforderung oder den Kontokontext.

Laufwerksbuchstaben auswählen und Freigabepfad angeben

Verwenden Sie einen Laufwerksbuchstaben, der in der Windows-Sitzung frei ist, in der Sie die Freigabe nutzen möchten. Der Remotepfad muss ein UNC-Pfad sein, der mit zwei umgekehrten Schrägstrichen beginnt, gefolgt von Server- und Freigabename, zum Beispiel \\FileServer\Team Files. Enthält der Pfad Leerzeichen, setzen Sie das Pfadargument in Anführungszeichen, damit es als ein Wert übergeben wird, zum Beispiel New-SMBMapping -LocalPath Z: -RemotePath '\\FileServer\Team Files'.

Ein Freigabepfad verweist auf einen freigegebenen Ordner, nicht unbedingt auf das gesamte Laufwerk eines Servers. Fragen Sie beim Serververantwortlichen nach dem genauen Freigabenamen. Eine Laufwerkszuordnung ist an den Benutzer- und Sitzungskontext gebunden, in dem sie erstellt wurde. Daher ist sie möglicherweise in einem anderen Kontext nicht sichtbar.

SMB-Zuordnungen überprüfen und verwalten

Prüfen Sie nach dem Erstellen einer Zuordnung die aktuellen Verbindungen, statt sich allein auf eine Erfolgsmeldung zu verlassen. Das Cmdlet Get-SMBMapping listet SMB-Zuordnungen auf; auch net use zeigt Netzwerkverbindungen an. Kontrollieren Sie, ob lokaler Laufwerkspfad und entfernter UNC-Pfad den gewünschten Werten entsprechen. Öffnen Sie anschließend das Laufwerk oder listen Sie dessen Inhalt auf, um zu prüfen, ob Ihr Konto auf die Freigabe zugreifen kann.

Um eine Zuordnung für Z: zu entfernen, verwenden Sie Remove-SMBMapping -LocalPath Z:. Mit dem älteren Befehl können Sie sie durch net use Z: /delete trennen. Diese Befehle wirken sich auf die ausgewählte Zuordnung aus. Prüfen Sie daher vor dem Entfernen den Laufwerksbuchstaben. Wenn der Zugriff fehlschlägt, kontrollieren Sie die Schreibweise von Server und Freigabe, die Netzwerkerreichbarkeit, die Kontoberechtigungen und ob die aktuelle Sitzung die erwarteten Anmeldeinformationen verwendet. Mit Get-Help New-SMBMapping -Full oder Get-Help Remove-SMBMapping -Full finden Sie Informationen zu den auf diesem System verfügbaren Optionen.

Persistenz, Anmeldeinformationen und häufige Einschränkungen

Ob und wie Zuordnungen bestehen bleiben und welche Optionen für Anmeldeinformationen verfügbar sind, kann von der Windows-Version, der Cmdlet-Implementierung und dem Kontokontext abhängen. Gehen Sie nicht allein aufgrund eines Befehlsbeispiels davon aus, dass eine Zuordnung nach der Anmeldung oder einem Neustart erneut verbunden wird. Informieren Sie sich in der Hilfe des installierten Befehls und in den Windows-Vorgaben Ihrer Organisation über unterstützte Optionen und deren Verhalten.

Hinterlegen Sie wiederverwendbare Kennwörter nicht direkt in Skripten, Artikelbeispielen oder Befehlen, die im Verlauf gespeichert werden könnten. Verwenden Sie das für Ihre Umgebung zugelassene Verfahren für Anmeldeinformationen und fragen Sie die Administration, ob das Konto für die Freigabe berechtigt ist. Ist eine Zuordnung in einer geplanten Aufgabe, einer Sitzung mit erhöhten Rechten oder der Sitzung eines anderen Benutzers nicht verfügbar, prüfen Sie, welche Identität und welcher Anmeldekontext für diesen Prozess gelten. Die Beispiele zeigen die Befehlsstruktur; sie belegen nicht, dass eine Verbindung mit einem bestimmten Server oder einer bestimmten Windows-Konfiguration getestet wurde.