在当前会话中创建 Windows PowerShell 驱动器。
语法
New-PSDrive [-Name] <string> [-PSProvider] <string> [-Root] <string> [-Credential <PSCredential>] [-Description <string>] [-Scope <string>] [-Confirm] [-WhatIf] [-UseTransaction] [<CommonParameters>]
说明
New-PSDrive cmdlet 创建“映射到”数据存储(如网络驱动器、本地计算机上的目录或注册表项)中的某一位置或与之关联的一个 Windows PowerShell 驱动器。
就像操作任何映射驱动器那样,可以使用创建的 Windows PowerShell 驱动器访问关联数据存储中的数据。可以更改驱动器中的位置(使用“set-location”、“cd”或“chdir”),并且可以访问驱动器的内容(使用“get-item”、“get-childitem”或“dir”)。
但是,Windows PowerShell 驱动器仅对 Windows PowerShell 是已知的。不能使用 Windows 资源管理器、Windows Management Instrumentation (WMI)、组件对象模型 (COM)、Microsoft .NET Framework 或使用类似 Net Use 的工具访问这些驱动器。
Windows PowerShell 驱动器仅存在于当前 Windows PowerShell 会话中。要使驱动器具有持久性,可以导出在其中添加了驱动器的会话,或者在 Windows PowerShell 配置文件中保存 New-PSDrive 命令。
要删除 New-PSDrive 所创建的驱动器,请使用 Remove-PSDrive cmdlet。
参数
-Credential <PSCredential>
指定有权执行此操作的用户帐户。默认值为当前用户。
键入用户名,例如“User01”或“Domain01\User01”。或者,输入 PSCredential 对象,例如由 Get-Credential cmdlet 生成的对象。如果键入用户名,则将提示您输入密码。
随同 Windows PowerShell 一起安装的任何提供程序都不支持此参数。
是否为必需? |
false |
位置? |
named |
默认值 |
|
是否接受管道输入? |
true (ByPropertyName) |
是否接受通配符? |
false |
-Description <string>
指定驱动器的简短文本说明。可键入任意字符串。
要查看系统上所有 Windows PowerShell 驱动器的说明,请键入“get-psdrive | format name, description”。要查看特定 Windows PowerShell 驱动器的说明,请键入“(get-psdrive <DriveName>).description”。
是否为必需? |
false |
位置? |
named |
默认值 |
|
是否接受管道输入? |
true (ByPropertyName) |
是否接受通配符? |
false |
-Name <string>
指定新驱动器的名称。可以对该名称使用任意有效字符串,而不仅限于驱动器号。Windows PowerShell 驱动器名称区分大小写。
是否为必需? |
true |
位置? |
1 |
默认值 |
|
是否接受管道输入? |
true (ByPropertyName) |
是否接受通配符? |
false |
-PSProvider <string>
指定支持此类型的驱动器的 Windows PowerShell 提供程序。
例如,如果 Windows PowerShell 驱动器与网络共享或文件系统目录关联,则 Windows PowerShell 提供程序为“FileSystem”。如果 Windows PowerShell 驱动器与注册表项关联,则提供程序为“Registry”。
要查看 Windows PowerShell 会话中提供程序的列表,请键入“get-psprovider”。
是否为必需? |
true |
位置? |
2 |
默认值 |
|
是否接受管道输入? |
true (ByPropertyName) |
是否接受通配符? |
false |
-Root <string>
指定 Windows PowerShell 驱动器映射到的数据存储位置。
例如,指定网络共享(如 \\Server01\Public)、本地目录(如 C:\Program Files)或注册表项(如 HKLM:\Software\Microsoft)。
是否为必需? |
true |
位置? |
3 |
默认值 |
|
是否接受管道输入? |
true (ByPropertyName) |
是否接受通配符? |
false |
-Scope <string>
指定驱动器的作用域。有效值包括“Global”、“Local”、“Script”或者相对于当前作用域的数字(0 到作用域数,其中 0 是指当前作用域,1 是指其父作用域)。默认值为“Local”。有关详细信息,请参阅 about_Scopes。
是否为必需? |
false |
位置? |
named |
默认值 |
|
是否接受管道输入? |
true (ByPropertyName) |
是否接受通配符? |
false |
-Confirm
在执行命令之前提示您进行确认。
是否为必需? |
false |
位置? |
named |
默认值 |
|
是否接受管道输入? |
false |
是否接受通配符? |
false |
-WhatIf
描述如果执行该命令会发生什么情况(无需实际执行该命令)。
是否为必需? |
false |
位置? |
named |
默认值 |
|
是否接受管道输入? |
false |
是否接受通配符? |
false |
-UseTransaction
将命令包含在活动事务中。仅当正在执行事务时,此参数才有效。有关详细信息,请参阅 about_Transactions。
是否为必需? |
false |
位置? |
named |
默认值 |
|
是否接受管道输入? |
false |
是否接受通配符? |
false |
<CommonParameters>
此 cmdlet 支持通用参数:-Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer 和 -OutVariable。有关详细信息,请参阅 about_Commonparameters.
输入和输出
输入类型是指可通过管道传递给 cmdlet 的对象的类型。返回类型是指 Cmdlet 所返回对象的类型。
输入 |
None 不能通过管道将输入传递给此 cmdlet。 |
输出 |
System.Management.Automation.PSDriveInfo |
说明
New-PSDrive cmdlet 用于处理由任何提供程序公开的数据。要列出会话中可用的提供程序,请键入“get-psprovider”。有关详细信息,请参阅 about_Providers。
示例 1
C:\PS>new-psdrive -name P -psprovider FileSystem -root \\Server01\Public Name Provider Root ---- -------- ---- P FileSystem \\Server01\Public 说明 ----------- 此命令创建一个 Windows PowerShell 驱动器,其功能类似于 Windows 中的映射网络驱动器。该命令创建一个名为 P: 的 Windows PowerShell 驱动器,该驱动器映射到 \\Server01\Public 网络共享。 该命令使用 Name 参数指定该驱动器的名称,使用 PSProvider 参数指定 Windows PowerShell FileSystem 提供程序,使用 Root 参数指定网络共享。 该命令完成后,\\Server01\Public 共享的内容即会显示在 P: 驱动器中。要查看这些内容,请键入:“dir p:”。
示例 2
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 说明 ----------- 此命令创建一个 Windows PowerShell 驱动器,用于提供对本地目录的快速访问。该命令创建一个名为 MyDocs: 的驱动器,该驱动器映射到本地计算机上的 “C:\Documents and Settings\User01\My Documents”目录。 该命令使用 Name 参数指定该驱动器的名称,使用 PSProvider 参数指定 Windows PowerShell FileSystem 提供程序,使用 Root 参数指定 My Documents 文件夹的路径,使用 Description 参数创建该驱动器的说明。 该命令完成后,My Documents 文件夹的内容即会显示在 MyDocs: 驱动器中。要查看这些内容,请键入:“dir mydocs:”。
示例 3
C:\PS>new-psdrive -name MyCompany -psprovider Registry -root HKLM:\Software\MyCompany Name Provider Root ---- -------- ---- MyCompany Registry HKEY_LOCAL_MACHINE\Software\MyCo... 说明 ----------- 此命令创建一个 Windows PowerShell 驱动器,用于提供对经常查看的注册表项的快速访问。该命令创建一个名为 MyCompany 的驱动器,该驱动器映射到 HKLM\Software\MyCompany 注册表项。 该命令使用 Name 参数指定该驱动器的名称,使用 PSProvider 参数指定 Windows PowerShell Registry 提供程序,使用 Root 参数指定注册表项。 该命令完成后,MyCompany 项的内容即会显示在 MyCompany: 驱动器中。要查看这些内容,请键入:“dir MyCompany:”。
示例 4
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 说明 ----------- 此示例说明映射到网络共享的 Windows 驱动器与映射到同一网络共享的 Windows PowerShell 驱动器之间的区别。 第一条命令使用 New-PSDrive cmdlet 创建一个名为 PSDrive: 的 Windows PowerShell 驱动器,该驱动器映射到 \\Server01\Public 网络共享。 第二组命令使用 New-Object cmdlet 创建一个 Wscript.Network COM 对象,然后使用其 MapNetworkDrive 方法将 \\Server01\Public 网络共享映射到本地计算机上的 X: 驱动器。 现在,可以检查这两个驱动器。执行 Get-PSDrive 驱动器命令后,这两个驱动器看起来似乎相同,但网络共享名称仅显示在 PSDrive: 驱动器的根目录中。 将这两个驱动器对象发送给 Get-Member 后,显示它们具有相同的对象类型 System.Management.Automation.PSDriveInfo。 但是,执行“net use”命令、对 Win32_LogicalDisk 类执行 Get-WmiObject 命令并对 Win32_NetworkConnection 类执行 Get-WmiObject 命令后,发现只有 X: 驱动器是使用 Wscript.Network 对象创建的。这是因为 Windows PowerShell 驱动器仅对 Windows PowerShell 是已知的。 如果关闭 Windows PowerShell 会话然后再打开一个新的会话,则 PSDrive: 驱动器将消失,而 X: 驱动器仍将保留。 因此,在决定使用哪一方法映射网络驱动器时,请考虑将如何使用驱动器,是否需要保留它,以及对 Windows 的其他功能而言,是否需要驱动器保持可见。
另请参阅