Remove-PSDrive
刪除暫存的 PowerShell 磁碟驅動器,並中斷連線對應的網路驅動器機。
語法
Name (預設值)
Remove-PSDrive
[-Name] <String[]>
[-PSProvider <String[]>]
[-Scope <String>]
[-Force]
[-WhatIf]
[-Confirm]
[-UseTransaction]
[<CommonParameters>]
LiteralName
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 也會中斷對應網路驅動器機的連線,包括但不限於使用 Persist的 New-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 |
-UseTransaction
在作用中交易中包含 命令。 只有在交易進行中時,此參數才有效。 如需詳細資訊,請參閱 about_Transactions。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | False |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | usetx |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | 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 傳送至 Remove-PSDrive Cmdlet。
輸出
None
此 Cmdlet 不會傳回任何輸出。
備註
-
Remove-PSDriveCmdlet 的設計目的是要處理任何 PowerShell 提供者所公開的數據。 若要列出會話中的提供者,請使用Get-PSProviderCmdlet。 如需詳細資訊,請參閱 about_Providers。