Bagikan melalui

Remove-PSDrive

Modul:
Microsoft.PowerShell.Management Module

Menghapus drive PowerShell sementara dan memutuskan sambungan drive jaringan yang dipetakan.

Sintaks

Name (Default) 

Remove-PSDrive
    [-Name] <String[]>
    [-PSProvider <String[]>]
    [-Scope <String>]
    [-Force]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

LiteralName 

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.

Properti parameter

Jenis:SwitchParameter
Nilai default:False
Mendukung wildcard:False
DontShow:False
Alias:Cf

Kumpulan parameter

(All)
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

-Force

Menghapus drive PowerShell saat ini.

Properti parameter

Jenis:SwitchParameter
Nilai default:False
Mendukung wildcard:False
DontShow:False

Kumpulan parameter

(All)
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

-LiteralName

Menentukan nama drive.

Nilai LiteralName digunakan persis seperti yang ditik. Tidak ada karakter yang ditafsirkan sebagai wildcard. Jika nama menyertakan karakter escape, sertakan dalam tanda kutip tunggal ('). Tanda kutip tunggal menginstruksikan PowerShell untuk tidak menginterpretasikan karakter apa pun sebagai urutan escape.

Properti parameter

Jenis:

String[]

Nilai default:None
Mendukung wildcard:False
DontShow:False

Kumpulan parameter

LiteralName
Position:0
Wajib:True
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:True
Nilai dari argumen yang tersisa:False

-Name

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

Properti parameter

Jenis:

String[]

Nilai default:None
Mendukung wildcard:True
DontShow:False

Kumpulan parameter

Name
Position:0
Wajib:True
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:True
Nilai dari argumen yang tersisa:False

-PSProvider

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

Properti parameter

Jenis:

String[]

Nilai default:None
Mendukung wildcard:False
DontShow:False

Kumpulan parameter

(All)
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:True
Nilai dari argumen yang tersisa: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.

Properti parameter

Jenis:String
Nilai default:Local
Mendukung wildcard:False
DontShow:False

Kumpulan parameter

(All)
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:True
Nilai dari argumen yang tersisa:False

-WhatIf

Menunjukkan apa yang akan terjadi ketika cmdlet dijalankan. Cmdlet tidak dijalankan.

Properti parameter

Jenis:SwitchParameter
Nilai default:False
Mendukung wildcard:False
DontShow:False
Alias:wi

Kumpulan parameter

(All)
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

CommonParameters

Cmdlet ini mendukung parameter umum: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, dan -WarningVariable. Untuk informasi selengkapnya, lihat about_CommonParameters.

Input

PSDriveInfo

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 cmdlet Get-PSProvider. Untuk informasi selengkapnya, lihat tentang_Penyedia.