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
定义驱动器的作用范围。 此参数的可接受值为:Global、Local和 Script,或相对于当前范围的数字。 范围数 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-PSDrivecmdlet 用于处理由任何 PowerShell 提供程序公开的数据。 若要列出会话中的提供程序,请使用Get-PSProvidercmdlet。 有关详细信息,请参阅 about_Providers。