New-PSDrive

New-PSDrive [-Name] <string> [-PSProvider] <string> [-Root] <string> [-Credential <PSCredential>] [-Description <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

Descrizione
-----------
Con questo comando viene creata un'unità di Windows PowerShell che funziona come un'unità di rete mappata in Windows. Viene creata un'unità di Windows PowerShell denominata P: mappata alla condivisione di rete \\Server01\Public. 

Vengono utilizzati il parametro Name per specificare un nome per l'unità, il parametro PSProvider per specificare il provider FileSystem di Windows PowerShell e il parametro Root per specificare la condivisione di rete.

Al completamento del comando, il contenuto della condivisione \\Server01\Public viene visualizzato nell'unità P:. Per visualizzarlo, digitare "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

Descrizione
-----------
Con questo comando viene creata un'unità di Windows PowerShell che consente di accedere rapidamente a una directory locale. Viene creata un'unità denominata MyDocs: mappata alla directory 
"C:\Documents and Settings\User01\My Documents" del computer locale.

Vengono utilizzati il parametro Name per specificare un nome per l'unità, il parametro PSProvider per specificare il provider FileSystem di Windows PowerShell, il parametro Root per specificare il percorso della cartella My Documents e il parametro Description per creare una descrizione dell'unità.


Al completamento del comando, il contenuto della cartella My Documents viene visualizzato nell'unità MyDocs:. Per visualizzarlo, digitare "dir mydocs:".

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

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

Descrizione
-----------
Con questo comando viene creata un'unità di Windows PowerShell che consente di accedere rapidamente a una chiave del Registro di sistema controllata spesso. Viene creata un'unità denominata MyCompany mappata alla chiave del Registro di sistema HKLM\Software\MyCompany. 

Vengono utilizzati il parametro Name per specificare un nome per l'unità, il parametro PSProvider per specificare il provider Registry di Windows PowerShell e il parametro Root per specificare la chiave del Registro di sistema.


Al completamento del comando, il contenuto della chiave MyCompany viene visualizzato nell'unità MyCompany:. Per visualizzarlo, digitare "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

Descrizione
-----------
In questo esempio viene illustrata la differenza tra un'unità di Windows e un'unità di Windows PowerShell mappate alla stessa condivisione di rete.

Nel primo comando viene utilizzato il cmdlet New-PSDrive per creare un'unità di Windows PowerShell denominata PSDrive: mappata alla condivisione di rete \\Server01\Public.

Nel secondo set di comandi viene utilizzato il cmdlet New-Object per creare un oggetto COM Wscript.Network, quindi viene utilizzato il metodo MapNetworkDrive per mappare la condivisione di rete \\Server01\Public all'unità X: nel computer locale. 

È ora possibile esaminare le due unità. Mediante l'utilizzo di un comando Get-PSDrive le unità sembrano essere uguali, anche se il nome della condivisione di rete viene visualizzato solo nella radice dell'unità PSDrive:.

L'invio degli oggetti unità a Get-Member indica che hanno lo stesso tipo di oggetto, System.Management.Automation.PSDriveInfo.

Tuttavia, l'esecuzione di un comando net use, di un comando Get-WmiObject alla classe Win32_LogicalDisk e di un comando Get-WmiObject alla classe Win32_NetworkConnection rileva solo l'unità X: creata tramite l'oggetto Wscript.Network. Questa situazione è dovuta al fatto che le unità di Windows PowerShell sono note solo a Windows PowerShell.

Se si chiude la sessione di Windows PowerShell, quindi se ne apre una nuova, l'unità PSDrive: non è più presente mentre l'unità X: persiste.

Pertanto, per decidere quale metodo utilizzare per mappare le unità di rete, è opportuno considerare in che modo verrà utilizzata l'unità, se deve essere permanente e se è necessario che sia visibile ad altre funzionalità di Windows.