New-PSDrive

Module:

Microsoft.PowerShell.Management

Crée des lecteurs réseau mappés temporaires et persistants.

Syntax

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 à un emplacement 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 active 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, en utilisant Set-Locationet en accédant 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 d’Explorateur de fichiers, de Windows Management Instrumentation (WMI), de modèle objet de composant (COM), de Microsoft .NET Framework ou d’outils tels que l’utilisation nette.

Les fonctionnalités suivantes ont été ajoutées dans 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 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 net usage. 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 dé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 du script. Pour obtenir de meilleurs résultats, 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 lecteur 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 lecteur PSDrive qui représente le lecteur supprimé.
• Informations d’identification pour les chemins 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 plaque pour réduire la longueur de 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-PSDrive utilise le paramètre Name pour spécifier le lecteur PowerShell nommé Public et le paramètre PSProvider pour spécifier le fournisseur PowerShell FileSystem . 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 de paramètre et les valeurs. 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 splatted 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-PSDrive utilise le paramètre Name pour spécifier le lecteur PowerShell nommé MyCompany et le paramètre PSProvider pour spécifier le fournisseur PowerShell Registry . 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

Notes

N’oubliez pas que si vous utilisez l’extrait de code ci-dessus dans un script, définissez la valeur du paramètre Scope sur « Global » pour garantir que le lecteur persiste en dehors de l’étendue actuelle.

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, la session 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

Paramètres

-Confirm

Vous demande une confirmation avant d’exécuter l’applet de commande.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Credential

Spécifie un compte d’utilisateur qui a l’autorisation d’effectuer cette action. La valeur par défaut est l’utilisateur actuel.

Étant donné que PowerShell 3.0, lorsque la valeur du paramètre Racine est un chemin UNC, vous pouvez utiliser les informations d’identification pour créer des lecteurs de système de fichiers.

Tapez un nom d’utilisateur, tel que User01 ou Domain01\User01, ou entrez un objet PSCredential généré par l’applet Get-Credential de commande. Si vous tapez un nom d’utilisateur, vous êtes invité à entrer le mot de passe.

Les informations d’identification sont stockées dans un objet PSCredential et le mot de passe est stocké en tant que SecureString.

Notes

Pour plus d’informations sur la protection des données SecureString , consultez Comment secure is SecureString ?.

Type:	PSCredential
Position:	Named
Default value:	Current user
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Description

Spécifie une courte description du lecteur. Tapez une chaîne.

Pour afficher les descriptions de tous les lecteurs de la session, Get-PSDrive | Format-Table Name, Description.

Pour afficher la description d’un lecteur particulier, tapez (Get-PSDrive <DriveName>).Description.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Name

Spécifie le nom du nouveau lecteur. Pour les lecteurs réseau mappés persistants, utilisez une lettre de lecteur. Pour les lecteurs PowerShell temporaires, vous n’êtes pas limité aux lettres de lecteur, utilisez n’importe quelle chaîne valide.

Type:	String
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Persist

Indique que cette applet de commande crée un lecteur réseau mappé Windows. Le paramètre Persist est disponible uniquement sur Windows.

Les lecteurs réseau mappés sont enregistrés dans Windows sur l'ordinateur local. Ils sont persistants, pas spécifiques à la session et peuvent être consultés et gérés dans Explorateur de fichiers et d’autres outils.

Lorsque vous limitez la commande 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 vous exécutez la commande. Si vous exécutez à l’intérieur d’un script et que vous souhaitez New-PSDrive que le nouveau lecteur persiste indéfiniment, vous devez dot-source du script. Pour obtenir de meilleurs résultats, pour forcer la persistance d’un nouveau lecteur, spécifiez Global comme valeur du paramètre Scope et incluez Persist dans votre commande.

Le nom du lecteur doit être une lettre, telle que D ou E. La valeur du paramètre Racine doit être un chemin UNC d’un autre ordinateur. La valeur du paramètre PSProvider doit être FileSystem.

Pour déconnecter un lecteur réseau mappé Windows, utilisez l'applet de commande Remove-PSDrive. Lorsque vous déconnectez un lecteur réseau Windows mappé, le mappage est définitivement supprimé de l'ordinateur (et pas simplement de la session active).

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 de différentes informations d’identification.

Type:	SwitchParameter
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-PSProvider

Spécifie le fournisseur PowerShell qui prend en charge les lecteurs de ce type.

Par exemple, si le lecteur est associé à un répertoire de partage réseau ou de système de fichiers, le fournisseur PowerShell est FileSystem. Si le lecteur est associé à une clé de Registre, le fournisseur est Registry.

Les lecteurs PowerShell temporaires peuvent être associés à n’importe quel fournisseur PowerShell. Les lecteurs réseau mappés ne peuvent être associés qu’au FileSystem fournisseur.

Pour afficher la liste des fournisseurs dans votre session PowerShell, utilisez l’applet de Get-PSProvider commande.

Type:	String
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Root

Spécifie l’emplacement du magasin de données auquel un lecteur PowerShell est mappé.

Par exemple, spécifiez un partage réseau, tel que \\Server01\Public, un répertoire local, tel que C:\Program Files, ou une clé de Registre, par exemple HKLM:\Software\Microsoft.

Les lecteurs PowerShell temporaires peuvent être associés à un emplacement local ou distant sur n’importe quel lecteur fournisseur pris en charge. Les lecteurs réseau mappés ne peuvent être associés qu'à un emplacement du système de fichiers sur un ordinateur distant.

Type:	String
Position:	2
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Scope

Spécifie une portée pour le lecteur. Les valeurs acceptables de ce paramètre sont les suivantes : Global, Local et Script, ou un nombre par rapport à l’étendue actuelle. Nombre d’étendues 0 par le nombre d’étendues. Le numéro d’étendue actuel est 0 et son parent est 1. Pour plus d’informations, consultez about_Scopes.

Type:	String
Position:	Named
Default value:	Local
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-WhatIf

Montre ce qui se passe en cas d’exécution de l’applet de commande. L’applet de commande n’est pas exécutée.

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Entrées

None

Vous ne pouvez pas pipeliner l’entrée dans cette applet de commande.

Sorties

PSDriveInfo

Notes

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 de différentes informations d’identification.

Liens associés

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