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>]
Description
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
指定磁碟驅動器的範圍。 此參數可接受的值為:Global、Local 和 Script,或相對於目前範圍的數位。 範圍數位 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 |
輸入
您可以使用管線將磁碟驅動器物件,例如從 Get-PSDrive
Cmdlet 傳送至 Remove-PSDrive
Cmdlet。
輸出
None
此 Cmdlet 不會傳回任何輸出。
備註
-
Remove-PSDrive
Cmdlet 的設計目的是要處理任何 PowerShell 提供者所公開的數據。 若要列出會話中的提供者,請使用Get-PSProvider
Cmdlet。 如需詳細資訊,請參閱 about_Providers。