New-PSDrive

Syntaxe

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

Description

L’applet New-PSDrive de commande crée des lecteurs temporaires et persistants mappés à ou associés à un emplacement dans un magasin de données, comme 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 les emplacements dans le lecteur, à l’aide Set-Locationde , et accéder au contenu du lecteur à l’aide Get-Item ou Get-ChildItem.

Étant donné que les lecteurs temporaires sont connus uniquement pour PowerShell, vous ne pouvez pas y accéder à l’aide de Explorateur de fichiers, de Windows Management Instrumentation (WMI), de Component Object Model (COM), de Microsoft .NET Framework ou d’outils tels que net use.

Les fonctionnalités suivantes ont été ajoutées à New-PSDrive PowerShell 3.0 :

• Lecteurs réseau mappés. Vous pouvez utiliser le paramètre Persist pour New-PSDrive 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 Explorateur de fichiers et l’utilisation nette. Les lecteurs réseau mappés doivent avoir un nom de lettre de lecteur et être connectés à un emplacement du système de fichiers distant. Lorsque votre commande est limitée localement, aucun point d’approvisionnement, 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 des résultats optimaux, pour forcer la persistance indéfinie d’un nouveau lecteur, ajoutez le paramètre Scope à votre commande et définissez sa valeur sur Global. Pour plus d’informations sur l’approvisionnement en points, consultez about_Scripts.
• 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 d’accès UNC (Universal Naming Convention).

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

Certains exemples de code utilisent la mise en plaques pour réduire la longueur de la ligne et améliorer la lisibilité. Pour plus d’informations, consultez about_Splatting.

Exemples

Exemple 1 : Créer un lecteur temporaire mappé à un partage réseau

Cet exemple crée un lecteur PowerShell temporaire mappé à un partage réseau.

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

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

New-PSDriveutilise le paramètre Name pour spécifier le lecteur PowerShell nommé Public et le paramètre PSProvider pour spécifier le fournisseur PowerShellFileSystem. Le paramètre Racine spécifie le chemin UNC du partage réseau.

Pour afficher le contenu d’une session PowerShell : Get-ChildItem -Path Public:

Exemple 2 : Créer un lecteur temporaire mappé à un répertoire local

Cet exemple crée un lecteur PowerShell temporaire qui fournit l’accès à un répertoire sur l’ordinateur local.

$parameters = @{
    Name = "MyDocs"
    PSProvider = "FileSystem"
    Root = "C:\Users\User01\Documents"
    Description = "Maps to my My Documents folder."
}
New-PSDrive @parameters

Name        Provider      Root
----        --------      ----
MyDocs      FileSystem    C:\Users\User01\Documents

La mise en forme crée les clés et valeurs de paramètre. Le paramètre Name spécifie le nom du lecteur, MyDocs. Le paramètre PSProvider spécifie le fournisseur PowerShell FileSystem . La racine spécifie le répertoire de l’ordinateur local. Le paramètre Description décrit l’objectif du lecteur. New-PSDrive utilise les paramètres platés pour créer le MyDocs lecteur.

Pour afficher le contenu d’une session PowerShell : Get-ChildItem -Path MyDocs:

Exemple 3 : Créer un lecteur temporaire pour une clé de Registre

Cet exemple crée un lecteur PowerShell temporaire qui fournit l’accès à une clé de Registre. Il crée un lecteur nommé MyCompany mappé à la clé de HKLM:\Software\MyCompany Registre.

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

Name           Provider      Root
----           --------      ----
MyCompany      Registry      HKLM:\Software\MyCompany

New-PSDriveutilise le paramètre Name pour spécifier le lecteur PowerShell nommé MyCompany et le paramètre PSProvider pour spécifier le fournisseur PowerShellRegistry. Le paramètre Racine spécifie l’emplacement du Registre.

Pour afficher le contenu d’une session PowerShell : Get-ChildItem -Path MyCompany:

Exemple 4 : Créer un lecteur réseau mappé persistant à l’aide d’informations d’identification

Cet exemple mappe un lecteur réseau authentifié avec les informations d’identification d’un compte de service de domaine. Pour plus d’informations sur l’objet PSCredential qui stocke les informations d’identification et la façon dont les mots de passe sont stockés en tant que SecureString, consultez la description du paramètre Credential .

$cred = Get-Credential -Credential Contoso\ServiceAccount
New-PSDrive -Name "S" -Root "\\Server01\Scripts" -Persist -PSProvider "FileSystem" -Credential $cred
Net Use

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

La $cred variable stocke un objet PSCredential qui contient les informations d’identification du compte de service. Get-Credential vous invite à entrer le mot de passe stocké dans un SecureString.

New-PSDrive crée le lecteur réseau mappé à l’aide de plusieurs paramètres. Le nom spécifie la lettre de S lecteur que Windows accepte. et Root définit \\Server01\Scripts comme emplacement sur un ordinateur distant. Persist crée un lecteur réseau mappé Windows enregistré sur l’ordinateur local. PSProvider spécifie le FileSystem fournisseur. Les informations d’identification utilisent la $cred variable pour obtenir les informations d’identification du compte de service pour l’authentification.

Le lecteur mappé peut être affiché sur l’ordinateur local dans les sessions PowerShell, Explorateur de fichiers et avec des outils tels que l’utilisation nette. Pour afficher le contenu d’une session PowerShell : Get-ChildItem -Path S:

Exemple 5 : Créer des lecteurs persistants et temporaires

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 une nouvelle session, le temporaire PSDrive: n’est pas disponible, mais le lecteur persistant X: est disponible. 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. Par exemple, s’il doit être persistant et si le lecteur doit être visible par d’autres fonctionnalités Windows.

# Create a temporary PowerShell drive called PSDrive:
# that's 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-CimInstance 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-CimInstance Win32_LogicalDisk | Format-Table -Property DeviceID
Get-CimInstance 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

Exemple 6 : Créer un lecteur persistant dans un script

Les disques PSDrive sont créés dans l’étendue dans laquelle la New-PSDrive commande est exécutée. Lorsque la commande est exécutée dans un script, le mappage de lecteur est local au script. Lorsque le script se ferme, le lecteur n’est plus disponible.

New-PSDrive -Persist -Name "X" -PSProvider "FileSystem" -Root "\\Server01\Public" -Scope Global

Pour vous assurer que le lecteur est disponible en dehors du script, vous devez utiliser le paramètre Scope pour créer le lecteur dans l’étendue globale .

Paramètres

-Confirm

-Credential

-Description

-Name

-Persist

-PSProvider

-Root

-Scope

-WhatIf

Entrées

None

Vous ne pouvez pas diriger les objets vers cette applet de commande

Sorties

PSDriveInfo

Cette applet de commande retourne un objet PSDriveInfo représentant le lecteur créé.

Notes

PowerShell inclut les alias suivants pour Get-PSDrive:

• Toutes les plateformes :
  • ndr
• Windows :
  • mount

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.

Liens associés

• about_Providers
• Get-Credential
• Get-PSDrive
• Remove-PSDrive