Remove-PSDrive

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

语法

Name (默认值)

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

LiteralName

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

说明

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

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

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
默认值:False
支持通配符:False
不显示:False
别名:cf

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-Force

删除当前的 PowerShell 驱动器。

参数属性

类型:SwitchParameter
默认值:False
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-LiteralName

指定驱动器的名称。

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

参数属性

类型:

String[]

默认值:None
支持通配符:False
不显示:False

参数集

LiteralName
Position:0
必需:True
来自管道的值:False
来自管道的值(按属性名称):True
来自剩余参数的值:False

-Name

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

参数属性

类型:

String[]

默认值:None
支持通配符:True
不显示:False

参数集

Name
Position:0
必需:True
来自管道的值:False
来自管道的值(按属性名称):True
来自剩余参数的值:False

-PSProvider

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

参数属性

类型:

String[]

默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):True
来自剩余参数的值:False

-Scope

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

参数属性

类型:String
默认值:Local
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):True
来自剩余参数的值:False

-WhatIf

显示 cmdlet 运行时会发生什么情况。 命令脚本未运行。

参数属性

类型:SwitchParameter
默认值:False
支持通配符:False
不显示:False
别名:无线

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

CommonParameters

此 cmdlet 支持通用参数:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息,请参阅 about_CommonParameters

输入

PSDriveInfo

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

输出

None

此 cmdlet 不返回任何输出。

备注

PowerShell 包含以下与 Remove-PSDrive相关的别名:

  • 所有平台:

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