New-PSDrive

New-PSDrive [-Name] <string> [-PSProvider] <string> [-Root] <string> [-Credential <PSCredential>] [-Descrição <string>] [-Scope <string>] [-Confirm] [-WhatIf] [-UseTransaction] [<CommonParameters>]

C:\PS>new-psdrive -name P -psprovider FileSystem -root \\Server01\Public

Name       Provider      Root
----       --------      ----
P          FileSystem    \\Server01\Public

Descrição
-----------
Esse comando cria uma unidade do Windows PowerShell que funciona como uma unidade de rede mapeada no Windows. O comando cria uma unidade do Windows PowerShell chamada P: que é mapeada para o compartilhamento de rede \\Server01\Public. 

Ele usa o parâmetro Name para especificar um nome para a unidade, o parâmetro PSProvider para especificar o provedor FileSystem do Windows PowerShell e o parâmetro Root para especificar o compartilhamento de rede.

Quando o comando é concluído, o conteúdo do compartilhamento \\Server01\Public aparece na unidade P:. Para vê-lo, digite "dir p:".

C:\PS>new-psdrive -name MyDocs -psprovider FileSystem -root "C:\Documents and Settings\User01\My Documents" -Description "Maps to my My Documents folder."

Name       Provider      Root
----       --------      ----
MyDocs     FileSystem    C:\Documents and Settings\User01\My Documents

Descrição
-----------
Esse comando cria uma unidade do Windows PowerShell que fornece acesso rápido a um diretório local. Ele cria uma unidade chamada MyDocs: que está mapeada para o 
o diretório "C:\Documents and Settings\User01\My Documents" no computador local.

Ele usa o parâmetro Name para especificar um nome para a unidade, o parâmetro PSProvider para especificar o provedor FileSystem do Windows PowerShell, o parâmetro Root para especificar o caminho até a pasta My Documents e o parâmetro Description para criar uma descrição da unidade.


Quando o comando é concluído, o conteúdo da pasta My Documents aparece na unidade MyDocs:. Para vê-lo, digite "dir mydocs:".

C:\PS>new-psdrive -name MyCompany -psprovider Registry -root HKLM:\Software\MyCompany

Name       Provider      Root
----       --------      ----
MyCompany  Registry      HKEY_LOCAL_MACHINE\Software\MyCo...

Descrição
-----------
Esse comando cria uma unidade do Windows PowerShell que fornece acesso rápido a uma chave do Registro verificada com frequência. Ele cria uma unidade chamada MyCompany que é mapeada para a chave do Registro HKLM\Software\MyCompany. 

Ele usa o parâmetro Name para especificar um nome para a unidade, o parâmetro PSProvider para especificar o provedor Registry do Windows PowerShell e o parâmetro Root para especificar a chave do Registro.


Quando o comando é concluído, o conteúdo da chave MyCompany aparece na unidade MyCompany:. Para vê-lo, digite "dir MyCompany:".

C:\PS>new-psdrive -name PsDrive -psprovider FileSystem -root \\Server01\Public

C:\PS> $drive = new-object -com wscript.network
C:\PS> $drive.MapNetworkDrive("X:", "\\Server01\Public")


C PS:\> get-psdrive public, x

Name       Provider      Root
----       --------      ----
PsDrive    FileSystem    \\Server01\public
X          FileSystem    X:\


C:\PS>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()
...



C:\PS> net use
Status       Local     Remote                    Network
---------------------------------------------------------------------------
             X:        \\server01\public         Microsoft Windows Network


C:\PS> get-wmiobject win32_logicaldisk | ft deviceid
deviceid
--------
C:
D:
X:

C:\PS> get-wmiobject win32_networkconnection
LocalName                     RemoteName                    ConnectionState               Status
---------                     ----------                    ---------------               ------
X:                            \\products\public             Disconnected                  Unavailable

Descrição
-----------
Este exemplo mostra a diferença entre uma unidade do Windows mapeada para um compartilhamento de rede e uma unidade do Windows PowerShell mapeada para o mesmo compartilhamento.

O primeiro comando usa o cmdlet New-PSDrive para criar uma nova unidade do Windows PowerShell chamada PSDrive que é mapeada para o compartilhamento de rede \\Server01\Public.

O segundo conjunto de comandos usa o cmdlet New-Object para criar um objeto COM Wscript.Network e usa o método MapNetworkDrive para mapear o compartilhamento de rede \\Server01\Public para a unidade X: no computador local. 

Agora você pode examinar as duas unidades. Usando um comando de unidade Get-PSDrive, as unidades parecem ser as mesmas, embora o nome do compartilhamento de rede apareça somente na raiz da unidade PSDrive:.

O envio dos objetos da unidade para Get-Member mostra que eles têm o mesmo tipo de objeto, System.Management.Automation.PSDriveInfo.

No entanto, um comando "net use", um comando Get-WmiObject para a classe Win32_LogicalDisk e um comando Get-WmiObject para a classe Win32_NetworkConnection localizam apenas a unidade X: criada usando o objeto Wscript.Network. Isso ocorre porque as unidades do Windows PowerShell são conhecidas apenas no Windows PowerShell.

Se você fechar a sessão do Windows PowerShell e abrir outra, a unidade PSDrive: desaparecerá e a unidade X: persistirá.

Dessa maneira, ao decidir qual método usar para mapear unidades de rede, leve em consideração como a unidade será usada, se ela precisa ser persistente e se precisa estar visível para outros recursos do Windows.