New-PSDrive

New-PSDrive
    [-Name] <String>
    [-PSProvider] <String>
    [-Root] <String>
    [-Description <String>]
    [-Scope <String>]
    [-Persist]
    [-Credential <PSCredential>]
    [-WhatIf]
    [-Confirm]
    [-UseTransaction]
    [<CommonParameters>]

L’applet de commande New-PSDrive crée des lecteurs temporaires et persistants mappés à un emplacement dans un magasin de données, tel qu’un lecteur réseau, un répertoire sur l’ordinateur local ou une clé de Registre, et des lecteurs réseau mappés par Windows persistants associés à un emplacement de système de fichiers sur un ordinateur distant.

Les lecteurs temporaires existent uniquement dans la session PowerShell actuelle et dans les sessions que vous créez dans la session active. Ils peuvent avoir n’importe quel nom valide dans PowerShell et peuvent être mappés à n’importe quelle ressource locale ou distante. Vous pouvez utiliser des lecteurs PowerShell temporaires pour accéder aux données dans le magasin de données associé, comme vous le feriez avec n’importe quel lecteur réseau mappé. Vous pouvez modifier des emplacements dans le lecteur, en utilisant Set-Location, cdou chdir, et accéder au contenu du lecteur à l’aide de Get-Item, Get-ChildItemou dir.

Toutefois, étant donné que les lecteurs temporaires sont connus uniquement pour PowerShell, vous ne pouvez pas y accéder à l’aide de l’Explorateur de fichiers, de Windows Management Instrumentation (WMI), du modèle objet de composant (COM) ou de Microsoft .NET Framework, ou à l’aide d’outils tels que Net Use.

Les fonctionnalités suivantes sont ajoutées à New-PSDrive dans Windows PowerShell 3.0 :

• Lecteurs réseau mappés. Vous pouvez utiliser le paramètre Conserver de New-PSDrive pour créer des lecteurs réseau mappés Windows. Contrairement aux lecteurs PowerShell temporaires, les lecteurs réseau mappés Par Windows ne sont pas spécifiques à la session. Ils sont enregistrés dans Windows et peuvent être gérés à l’aide d’outils Windows standard, tels que l’Explorateur de fichiers et Net Use. Les lecteurs réseau mappés doivent avoir un nom de lettre de lecteur et être connectés à un emplacement de système de fichiers distant. Lorsque votre commande est délimitée localement (sans approvisionnement en points), le paramètre Persist ne conserve pas la création d’un PSDrive au-delà de l’étendue dans laquelle la commande est en cours d’exécution. Si vous exécutez New-PSDrive à l’intérieur d’un script et que vous souhaitez que le lecteur persiste indéfiniment, vous devez créer un point source sur le script. Pour obtenir de meilleurs résultats, pour forcer la persistance indéfinie d’un nouveau lecteur, ajoutez le paramètre étendue à votre commande et définissez sa valeur sur Global.
• Lecteurs externes. Lorsqu’un lecteur externe est connecté à l’ordinateur, PowerShell ajoute automatiquement un PSDrive au système de fichiers qui représente le nouveau lecteur. Vous n’avez pas besoin de redémarrer PowerShell. De même, lorsqu’un lecteur externe est déconnecté de l’ordinateur, PowerShell supprime automatiquement le PSDrive qui représente le lecteur supprimé.
• Informations d’identification pour les chemins UNC.

Lorsque la valeur du paramètre racine est un chemin UNC, tel que \\Server\Share, les informations d’identification spécifiées dans la valeur du paramètre Credential sont utilisées pour créer le PSDrive. Sinon, d’informations d’identification n’est pas efficace lorsque vous créez des lecteurs de système de fichiers.

New-PSDrive -Name "P" -PSProvider "FileSystem" -Root "\\Server01\Public"

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

Cette commande crée un lecteur PowerShell temporaire nommé P : mappé au partage réseau public \\Server01\Public.

Il utilise le paramètre Name pour spécifier un nom pour le lecteur, le paramètre PSProvider pour spécifier le fournisseur PowerShell FileSystem et le paramètre Racine pour spécifier le partage réseau.

Une fois la commande terminée, le contenu du partage \\Server01\Public apparaît dans le lecteur P : . Pour les voir, tapez : dir P:.

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

Cette commande crée un lecteur PowerShell temporaire qui fournit un accès rapide à un répertoire local. Il crée un lecteur nommé MyDocs : mappé au répertoire « C :\Documents et Paramètres\User01\Mes documents » sur l’ordinateur local.

Il utilise Name pour spécifier un nom pour le lecteur, PSProvider pour spécifier le fournisseur PowerShell FileSystem, Root pour spécifier le chemin du dossier Mes documents et le paramètre Description pour créer une description du lecteur.

Une fois la commande terminée, le contenu du dossier Mes documents apparaît dans le lecteur MyDocs:. Pour les voir, tapez : dir MyDocs:.

New-PSDrive -Name "MyCompany" -PSProvider "Registry" -Root "HKLM:\Software\MyCompany"

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

Cette commande crée un lecteur PowerShell temporaire qui fournit un accès rapide à une clé de Registre fréquemment vérifiée. Il crée un lecteur nommé MyCompany mappé à la clé de Registre HKLM\Software\MyCompany.

Il utilise Nom pour spécifier un nom pour le lecteur, PSProvider pour spécifier le fournisseur de Registre PowerShell et Racine pour spécifier la clé de Registre.

Une fois la commande terminée, le contenu de la clé MyCompany apparaît dans le lecteur MyCompany:. Pour les voir, tapez : dir MyCompany:.

New-PSDrive -Name "S" -Root "\\Server01\Scripts" -Persist -PSProvider "FileSystem"
Net Use

Status       Local     Remote                    Network
---------------------------------------------------------
OK           S:        \\Server01\Scripts        Microsoft Windows Network

Cette commande crée le lecteur réseau mappé « S » sur l’ordinateur local. Le lecteur « S » est mappé au partage réseau \\Server01\Scripts.

La commande utilise New-PSDrive pour créer le lecteur réseau mappé. Il utilise persist pour créer un lecteur réseau mappé Windows enregistré sur l’ordinateur local.

La commande utilise Nom pour spécifier un nom de lettre que Windows accepte et racine pour spécifier un emplacement sur un ordinateur distant. Il utilise PSProvider pour spécifier le fournisseur FileSystem.

Le lecteur résultant peut être affiché dans d’autres sessions PowerShell sur l’ordinateur local, dans l’Explorateur Windows et dans d’autres outils, tels que Net Use.

# Create a temporary PowerShell drive called PSDrive: that is mapped to the \\Server01\Public network share.
New-PSDrive -Name "PSDrive" -PSProvider "FileSystem" -Root "\\Server01\Public"
# Use the *Persist* parameter of **New-PSDrive** to create the X: mapped network drive, which is also mapped to the \\Server01\Public network share.
New-PSDrive -Persist -Name "X" -PSProvider "FileSystem" -Root "\\Server01\Public"
# Now, you can use the **Get-PSDrive** drive cmdlet to examine the two drives. The drives appear to be the same, although the network share name appears only in the root of the PSDrive: drive.
Get-PSDrive -Name "PSDrive", "X"

Name       Provider      Root
----       --------      ----

PsDrive    FileSystem    \\Server01\public
X          FileSystem    X:\

# Get-Member cmdlet shows that the drives have the same object type, System.Management.Automation.PSDriveInfo.
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()
...

# Net Use and Get-WmiObject for the Win32_LogicalDisk class, and Win32_NetworkConnection class find only the persistent X: drive.
# PowerShell temporary drives are known only to PowerShell.
Net Use
Get-WmiObject Win32_LogicalDisk | Format-Table -Property DeviceID
Get-WmiObject Win32_NetworkConnection

Status       Local     Remote                    Network
--------------------------------------------------------
OK           X:        \\contoso-pc\data            Microsoft Windows Network

deviceid
--------
C:
D:
X:

LocalName                  RemoteName                 ConnectionState            Status
---------                  ----------              ---------------               ------
X:                         \\products\public          Disconnected               Unavailable

Cet exemple montre la différence entre un lecteur réseau mappé persistant et un lecteur PowerShell temporaire mappé au même partage réseau.

Si vous fermez la session PowerShell, puis ouvrez-en une nouvelle, le lecteur PSDrive : est parti et le lecteur X: persiste. Par conséquent, lorsque vous décidez de la méthode à utiliser pour mapper les lecteurs réseau, réfléchissez à la façon dont vous utiliserez le lecteur, s’il doit être persistant et si le lecteur doit être visible par d’autres fonctionnalités Windows.

Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.

Vous ne pouvez pas diriger d'entrée vers cette applet de commande.

• New-PSDrive est conçu pour fonctionner avec les données exposées par n’importe quel fournisseur. Pour répertorier les fournisseurs disponibles dans votre session, utilisez Get-PSProvider. Pour plus d’informations sur les fournisseurs, consultez about_Providers.
• Les lecteurs réseau mappés sont spécifiques à un compte d’utilisateur. Les lecteurs mappés créés dans des sessions ou des sessions avec élévation de privilèges à l’aide des informations d’identification d’un autre utilisateur ne sont pas visibles dans les sessions démarrées à l’aide d’informations d’identification différentes.