Remove-PSDrive

删除临时 PowerShell 驱动器并断开映射的网络驱动器的连接。

语法

Remove-PSDrive
      [-Name] <String[]>
      [-PSProvider <String[]>]
      [-Scope <String>]
      [-Force]
      [-WhatIf]
      [-Confirm]
      [-UseTransaction]
      [<CommonParameters>]
Remove-PSDrive
      [-LiteralName] <String[]>
      [-PSProvider <String[]>]
      [-Scope <String>]
      [-Force]
      [-WhatIf]
      [-Confirm]
      [-UseTransaction]
      [<CommonParameters>]

说明

Remove-PSDrive cmdlet 删除使用 New-PSDrive cmdlet 创建的临时 PowerShell 驱动器。

从 Windows PowerShell 3.0 开始,Remove-PSDrive 还会断开到映射的网络驱动器的连接,包括但不限于使用 New-PSDrive 的 Persist 参数创建的驱动器。

Remove-PSDrive 无法删除 Windows 物理或逻辑驱动器。

从 Windows PowerShell 3.0 开始,当外部驱动器连接到计算机时,PowerShell 自动将 PSDrive 添加到代表新驱动器的文件系统中。 你无需重启 PowerShell。 简单来说,当从计算机断开外部驱动器的连接时,PowerShell 会自动删除代表删除的驱动器的 PSDrive。

示例

示例 1:删除文件系统驱动器

此命令删除一个名为“smp”的临时文件系统驱动器。

Remove-PSDrive -Name smp

示例 2:删除映射的网络驱动器

此命令使用 Remove-PSDrive 以断开 X:S: 映射网络驱动器的连接。

Get-PSDrive X, S | Remove-PSDrive

参数

-Confirm

提示你在运行 cmdlet 之前进行确认。

类型:SwitchParameter
别名:cf
Position:Named
默认值:False
必需:False
接受管道输入:False
接受通配符:False

-Force

删除当前 PowerShell 驱动器。

类型:SwitchParameter
Position:Named
默认值:False
必需:False
接受管道输入:False
接受通配符:False

-LiteralName

指定驱动器的名称。

LiteralName 的值严格按照所键入的形式使用。 不会将任何字符解释为通配符。 如果名称包括转义符,请将其括在单引号中 (')。 单引号会告知 PowerShell 不要将任意字符解释为转义序列。

类型:String[]
Position:0
默认值:None
必需:True
接受管道输入:True
接受通配符:False

-Name

指定要删除的驱动器的名称。 请不要在驱动器名称后面键入冒号 (:)。

类型:String[]
Position:0
默认值:None
必需:True
接受管道输入:True
接受通配符:True

-PSProvider

指定 PSProvider 对象的数组。 此 cmdlet 删除与指定的 PowerShell 提供程序关联的所有驱动器并断开与它们的连接。

类型:String[]
Position:Named
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-Scope

指定驱动器的作用域。 此参数的可接受值为 GlobalLocalScript,或相对于当前范围的数字。 范围数 0 到范围数。 当前范围数为 0,其父级为 1。 有关详细信息,请参阅 about_Scopes

类型:String
Position:Named
默认值:Local
必需:False
接受管道输入:True
接受通配符:False

-UseTransaction

在活动事务中使用该命令。 仅当正在执行事务时,此参数才有效。 有关详细信息,请参阅 about_Transactions

类型:SwitchParameter
别名:usetx
Position:Named
默认值:False
必需:False
接受管道输入:False
接受通配符:False

-WhatIf

显示运行该 cmdlet 时会发生什么情况。 cmdlet 未运行。

类型:SwitchParameter
别名:wi
Position:Named
默认值:False
必需:False
接受管道输入:False
接受通配符:False

输入

PSDriveInfo

可以通过管道将驱动器对象(例如来自Get-PSDrive cmdlet 的对象)传递给此 cmdlet。

输出

None

此 cmdlet 不返回任何输出。

备注

Windows PowerShell 包含 Remove-PSDrive 的以下别名:

  • rdr

  • Remove-PSDrive cmdlet 用于处理由任何 PowerShell 提供程序公开的数据。 若要列出会话中的提供程序,请使用 Get-PSProvider cmdlet。 有关详细信息,请参阅 about_Providers