Remove-PSDrive
Menghapus drive PowerShell sementara dan memutuskan sambungan drive jaringan yang dipetakan.
Sintaks
Remove-PSDrive
[-Name] <String[]>
[-PSProvider <String[]>]
[-Scope <String>]
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Remove-PSDrive
[-LiteralName] <String[]>
[-PSProvider <String[]>]
[-Scope <String>]
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Deskripsi
cmdlet Remove-PSDrive
menghapus drive PowerShell sementara yang dibuat dengan menggunakan cmdlet New-PSDrive
.
Dimulai di Windows PowerShell 3.0, Remove-PSDrive
juga memutuskan sambungan drive jaringan yang dipetakan, termasuk, tetapi tidak terbatas pada, drive yang dibuat dengan menggunakan parameter PersistNew-PSDrive
.
Remove-PSDrive
tidak dapat menghapus drive fisik atau logis Windows.
Dimulai di Windows PowerShell 3.0, saat drive eksternal tersambung ke komputer, PowerShell secara otomatis menambahkan PSDrive ke sistem file yang mewakili drive baru. Anda tidak perlu memulai ulang PowerShell. Demikian pula, ketika drive eksternal terputus dari komputer, PowerShell secara otomatis menghapus PSDrive yang mewakili drive yang dihapus.
Contoh
Contoh 1: Menghapus drive sistem file
Perintah ini menghapus drive sistem file sementara bernama smp
.
Remove-PSDrive -Name smp
Contoh 2: Menghapus drive jaringan yang dipetakan
Perintah ini menggunakan Remove-PSDrive
untuk memutuskan sambungan X:
dan S:
drive jaringan yang dipetakan.
Get-PSDrive X, S | Remove-PSDrive
Parameter
-Confirm
Meminta konfirmasi sebelum menjalankan cmdlet.
Jenis: | SwitchParameter |
Alias: | cf |
Position: | Named |
Nilai default: | False |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | False |
-Force
Menghapus drive PowerShell saat ini.
Jenis: | SwitchParameter |
Position: | Named |
Nilai default: | False |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | False |
-LiteralName
Menentukan nama drive.
Nilai LiteralName digunakan persis seperti yang ditik. Tidak ada karakter yang ditafsirkan sebagai kartubebas.
Jika nama menyertakan karakter escape, sertakan dalam tanda kutip tunggal ('
). Tanda kutip tunggal menginstruksikan PowerShell untuk tidak menginterpretasikan karakter apa pun sebagai urutan escape.
Jenis: | String[] |
Position: | 0 |
Nilai default: | None |
Diperlukan: | True |
Terima input alur: | True |
Terima karakter wildcard: | False |
-Name
Menentukan nama kandar yang akan dihapus. Jangan ketik titik dua (:
) setelah nama drive.
Jenis: | String[] |
Position: | 0 |
Nilai default: | None |
Diperlukan: | True |
Terima input alur: | True |
Terima karakter wildcard: | True |
-PSProvider
Menentukan array objek PSProvider. Cmdlet ini menghapus dan memutuskan sambungan semua drive yang terkait dengan penyedia PowerShell yang ditentukan.
Jenis: | String[] |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | True |
Terima karakter wildcard: | False |
-Scope
Menentukan cakupan untuk drive. Nilai yang dapat diterima untuk parameter ini adalah: Global
, Local
, dan Script
, atau angka yang relatif terhadap cakupan saat ini. Cakupan jumlah 0
melalui jumlah cakupan. Nomor cakupan saat ini 0
dan induknya 1
. Untuk informasi selengkapnya, lihat about_Scopes.
Jenis: | String |
Position: | Named |
Nilai default: | Local |
Diperlukan: | False |
Terima input alur: | True |
Terima karakter wildcard: | False |
-WhatIf
Menunjukkan apa yang akan terjadi jika cmdlet berjalan. Cmdlet tidak dijalankan.
Jenis: | SwitchParameter |
Alias: | wi |
Position: | Named |
Nilai default: | False |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | False |
Input
Anda dapat menyalurkan objek drive, seperti dari cmdlet Get-PSDrive
, ke cmdlet ini.
Output
None
Cmdlet ini tidak mengembalikan output.
Catatan
PowerShell menyertakan alias berikut untuk Remove-PSDrive
:
Semua platform:
rdr
Cmdlet
Remove-PSDrive
dirancang untuk bekerja dengan data yang diekspos oleh penyedia PowerShell apa pun. Untuk mencantumkan penyedia dalam sesi Anda, gunakan cmdletGet-PSProvider
. Untuk informasi selengkapnya, lihat about_Providers.