Netzlaufwerke verbinden mit Powershell und net use

Auch wenn Net Use direkt aufgerufen werden kann, ein wenig komfortabler geht es mit dem Start-Process-Cmdlet, da sich hier z.B. Fehlermeldungen in eine Datei umleiten lassen.

Die folgende Funktion erwartet Laufwerksname, Freigabename und ein PSCredential-Objekt für die Anmeldung als Parameter und verbindet die Freigabe mit dem übergebenenLaufwerksbuchstaben.

<#
 .Synopsis
 Laufwerksbuchstabe mit einer Freigabe verbinden
#>

function Connect-Share
{
 param([String]$DriveName,[String]$ShareName,[Object]$Credential)
 # Wurde ein PSCrendential-Object übergeben?
 if ($Credential -is [System.Management.Automation.PSCredential])
 {
  $Cred = [System.Management.Automation.PSCredential]$Credential
 }
 else
 {
  $Cred = Get-Credential -Credential $Credential
 }
 $Password = $Cred.GetNetworkCredential().Password
 $UserName = $Cred.UserName.Substring(1) # ohne das \-Zeichen
 del CmdError.txt -ErrorAction SilentlyContinue
 $P = Start-Process -Filepath cmd -NoNewWindow -Wait -RedirectStandardError CmdError.txt `
   -ArgumentList "/c net use $DriveName $ShareName $Password /user:$UserName" `
   -PassThru
 if ($P.ExitCode -eq 0)
 { "Freigabe $ShareName wurde mit Laufewerk $DriveName verbunden." }
 else
 { "Fehler: Freigabe $ShareName konnte nicht verbunden werden. $(Get-Content CmdError.txt)" }
}

Auch Funktionen sollen die Namenskovention Verb-Hauptwort einhalten. Um die Funktion trotzdem etwas einfacher eingeben zu können, wird ein Alias definiert:

New-Alias -Name NetUse -Value Connect-Share

Der Aufruf sieht wie folgt aus:

NetUse -DriveName P: -ShareName \\PMServer\PsKurs -Credential Administrator

Da für den Credential-Parameter bei diesem Aufruf ein String übergeben wird, wird das Kennwort bei der Ausführung der Funktion abgefragt. Alternativ kann ein Objekt vom Typ PSCredential übergeben werden, das zuvor über Get-Credential geholt wurde.