Skip to content

PowerShell - Map Network Drive

Source: https://powershellmagazine.com/2014/07/21/pstip-create-mapped-network-drive-using-wscript-network/ See Also: https://docs.microsoft.com/en-us/windows-server/administration/windows-commands/wscript Backlink: Log - New Discoveries > Map Network Drive with PowerShell

Used at Work

Used to map the Philadelphia network drive (\\Mphiafilefsp001\ABS_PHI1_GRP\Assurance\FS\AIMS) to drive letter Y::

(New-Object -ComObject WScript.Network).MapNetworkDrive("Y:", "\\Mphiafilefsp001\ABS_PHI1_GRP\Assurance\FS\AIMS",$true)

Implementation

$drv = $(New-Object -Com WScript.Network)
$drv.MapNetworkDrive("Y:", "\\<server>\<path\to\folder>")

or a one-liner:

(New-Object -ComObject WScript.Network).MapNetworkDrive('Z:','\\server\folder')

Persistent Mapped Drive

This will not map the drive persistently. In other words, the drive will disappear after reboot or when a user logs out. To ensure the drive mapping is persistent a third argument should be added–a Boolean value set to true:

(New-Object -ComObject WScript.Network).MapNetworkDrive('Z:','\\server\folder',$true)

It is also possible to specify a username and password. Unfortunately, both the username and password have to be supplied as plain text. An example of how to map a drive using alternate credentials:

(New-Object -ComObject WScript.Network).MapNetworkDrive('Z:','\\server\folder',$true,'domain\user','password')

A drive mapping might already be present using the drive letter that we want to use for the new mapped drive. The RemoveNetworkDrive method of the WScript.Network object can be utilized to remove a mapped network drive:

(New-Object -ComObject WScript.Network).RemoveNetworkDrive('Z:')

When there are open connections to the mapped drive, an error will be thrown when executing the previous command. To forcefully disconnect a drive mapping add $true as the second argument.

(New-Object -ComObject WScript.Network).RemoveNetworkDrive('Z:',$true)

For more details about these two methods and available arguments see the following articles on MSDN:

Backlinks:

list from [[PowerShell - Map Network Drive]] AND -"Changelog"