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
Cmdlet 會 Remove-PSDrive
刪除使用 Cmdlet 建立的 New-PSDrive
暫存 PowerShell 磁碟驅動器。
從 Windows PowerShell 3.0 開始,Remove-PSDrive
也會中斷對應網路驅動器機的連線,包括使用的 Persist 參數New-PSDrive
所建立的磁碟驅動器,但不受限制。
Remove-PSDrive
無法刪除 Windows 實體或邏輯磁碟驅動器。
從 Windows PowerShell 3.0 開始,當外部磁碟驅動器連線到計算機時,PowerShell 會自動將 PSDrive 新增至代表新磁碟驅動器的文件系統。 您不需要重新啟動 PowerShell。 同樣地,當外部磁碟驅動器與計算機中斷連線時,PowerShell 會自動刪除代表已移除磁碟驅動器的 PSDrive。
範例
範例 1:移除檔系統磁碟驅動器
此命令會移除名為 smp
的暫存檔案系統磁碟驅動器。
Remove-PSDrive -Name smp
範例 2:移除對應的網路驅動器機
此命令會使用 Remove-PSDrive
來中斷和S:
對應網路驅動器機的X:
連線。
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 傳送至此 Cmdlet。
輸出
None
此 Cmdlet 不會傳回任何輸出。
備註
Windows PowerShell 包含下列的 Remove-PSDrive
別名:
rdr
Cmdlet
Remove-PSDrive
的設計目的是要處理任何 PowerShell 提供者所公開的數據。 若要列出會話中的提供者,請使用Get-PSProvider
Cmdlet。 如需詳細資訊,請參閱 about_Providers。