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.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

Menghapus drive PowerShell saat ini.

Type:SwitchParameter
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:String[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Name

Menentukan nama kandar yang akan dihapus. Jangan ketik titik dua (:) setelah nama drive.

Type:String[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:True

-PSProvider

Menentukan array objek PSProvider . Cmdlet ini menghapus dan memutuskan sambungan semua drive yang terkait dengan penyedia PowerShell yang ditentukan.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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.

Type:String
Position:Named
Default value:Local
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

Menunjukkan apa yang akan terjadi jika cmdlet berjalan. Cmdlet tidak dijalankan.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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.