Create a temporary or persistent mapped network drive. (ndr, mount)

      New-PSDrive [-name] string -PSProvider string [-Persist]
         [-root] string [-description string] [-scope string]
            [-credential PSCredential] [-WhatIf] [-confirm] [-UseTransaction] [CommonParameters]

       The PowerShell drive name to be added.
       This is not limited to drive letters,any valid string may be used.
       PowerShell drives names are case-sensitive.

       The name of the provider, if omitted you will be prompted.
       e.g. FileSystem, Registry or Certificate.
       type get-psprovider for a list of providers.

       Create a mapped network drive. Mapped network drives are persistent, not session-specific, and can be
       viewed and managed in File Explorer and other tools. (PowerShell 3.0+)

       The name of the drive must be a letter, such as D or E. The value of the Root parameter must be a UNC path
       to a different computer. The value of the PSProvider parameter must be FileSystem.

       To disconnect a mapped network drive, use Remove-PSDrive.
       When you disconnect a mapped network drive, the mapping is permanently deleted from the computer, not just
       deleted from the current session.

       Mapped network drives are specific to a user account.
       Mapped network drives that you create in sessions that are started with the "Run as administrator" option or
       with the credential of another user are not visible in a session that started without explicit credentials or
       with the credentials of the current user.

   -root string
       The data store location that the PowerShell drive will be mapped to.

       e.g. a network share (\\Server64\files), a local directory (C:\Programs),
       or a registry key (HKLM:\Software\Microsoft).

   -description string
       A short description of the drive.

       A scope for the drive.
       Valid values are "Global", "Local", or "Script", or a number relative
       to the current scope (0 through the number of scopes, where 0 is the
       current scope and 1 is its parent).
       "Local" is the default. For more information, see about_Scopes.

   -credential PSCredential
       A user account that has permission to perform this action.
       The default is the current user.
       a user-name, such as "User01" or "Domain01\User01", or a PSCredential
       object, such as the one retrieved by using the Get-Credential cmdlet.
       If you type a user name, you will be prompted for a password.
       This parameter is not supported by any providers installed with PowerShell.

       Describe what would happen if you executed the command without
       actually executing the command.

       Prompt for confirmation before executing the command.

       Include the command in the active transaction.

       -Verbose, -Debug, -ErrorAction, -ErrorVariable, -WarningAction, -WarningVariable,
       -OutBuffer -OutVariable.

Standard Aliases for New-PSDrive: mount, ndr

New-PSDrive creates a PowerShell drive that is "mapped" to a location in a data store, such as a network drive, a directory on the local computer, or a registry key.

If a non-persistent drive is mapped (without the -Persist option) the drive will be visible only within PowerShell, not to Windows Explorer, net use or Get-WmiObject Win32_NetworkConnection


Install a drive called 'SS64' using the file system provider. The drive will be rooted at "C:\MyDocs":

PS C:\> new-psdrive -name SS64 -psProvider FileSystem -root C:\MyDocs -persist

Install a drive called 'S:' using the file system provider. The drive will be rooted at \\Server64\teams:

PS C:\> new-psdrive -name S -PsProvider FileSystem -root \\Server64\teams -persist
PS S:\> DIR S:

The parameters are positional, so
PS C:\> New-PSDrive -name M -psprovider FileSystem -root \\Server\Share

is the same as
PS C:\> New-PSDrive M FileSystem \\Server\Share

Map a drive using VBScript, calling .MapNetworkDrive from a Wscript.Network COM object, this method will make a persistent drive map:

PS C:\> $drive = new-object -com
PS C:\> $drive.MapNetworkDrive("S:", "\\Server64\teams")

"If the automobile had followed the same development cycle as the computer, a Rolls-Royce would today cost $100, get a million miles per gallon, and explode once a year, killing everyone inside" ~ Robert X. Cringely, InfoWorld


Get-PSDrive - Get drive information (DriveInfo)
Remove-PSDrive - Remove a provider/drive from its location
Get-Command - Retrieve basic information about a command
Get-Member - Enumerate the properties of an object
Equivalent bash command: mount - Mount a file system

© Copyright 1999-2015
Some rights reserved