Bagikan melalui

Remove-PSDrive

  • Referensi
Modul:
Microsoft.PowerShell.Management

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

Remove-PSDrive Cmdlet menghapus drive PowerShell sementara yang dibuat dengan menggunakan New-PSDrive cmdlet.

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 Persist dari New-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 digunakan Remove-PSDrive untuk memutuskan sambungan drive jaringan dan S: yang dipetakanX:.

Get-PSDrive X, S | Remove-PSDrive

Parameter

-Confirm

Meminta Anda mengonfirmasi 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, , Localdan Script, atau angka yang relatif terhadap cakupan saat ini. Cakupan nomor 0 melalui jumlah cakupan. Nomor cakupan saat ini adalah 0 dan induknya adalah 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

PSDriveInfo

Anda dapat menyalurkan objek drive, seperti dari Get-PSDrive cmdlet, ke cmdlet ini.

Output

None

Cmdlet ini tidak mengembalikan output.

Catatan

PowerShell menyertakan alias berikut untuk Remove-PSDrive:

  • Semua platform:

    • rdr

  • Remove-PSDrive Cmdlet dirancang untuk bekerja dengan data yang diekspos oleh penyedia PowerShell apa pun. Untuk mencantumkan penyedia dalam sesi Anda, gunakan Get-PSProvider cmdlet . Untuk informasi selengkapnya, lihat about_Providers.