Bagikan melalui

Remove-Variable

  • Referensi
Modul:
Microsoft.PowerShell.Utility

Menghapus variabel dan nilainya.

Sintaks

Remove-Variable
      [-Name] <String[]>
      [-Include <String[]>]
      [-Exclude <String[]>]
      [-Force]
      [-Scope <String>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Deskripsi

Remove-Variable Cmdlet menghapus variabel dan nilainya dari cakupan di mana cmdlet didefinisikan, seperti sesi saat ini. Anda tidak dapat menggunakan cmdlet ini untuk menghapus variabel yang diatur sebagai konstanta atau yang dimiliki oleh sistem.

Contoh

Contoh 1: Menghapus variabel

Remove-Variable Smp

Perintah ini menghapus $Smp variabel.

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

-Exclude

Menentukan array item yang dihilangkan cmdlet ini dari operasi. Nilai parameter ini memenuhi syarat parameter Nama . Masukkan elemen atau pola nama, seperti "s*". Kartubebas diizinkan.

Jenis:String[]
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:True

-Force

Menunjukkan bahwa cmdlet menghapus variabel meskipun bersifat baca-saja. Bahkan menggunakan parameter Paksa , cmdlet tidak dapat menghapus konstanta.

Jenis:SwitchParameter
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-Include

Menentukan array item yang dihapus cmdlet ini dalam operasi. Nilai parameter ini memenuhi syarat parameter Nama . Masukkan elemen atau pola nama, seperti s*. Kartubebas diizinkan.

Jenis:String[]
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:True

-Name

Menentukan nama variabel yang akan dihapus. Nama parameter (Nama) bersifat opsional. Kartubebas diizinkan

Jenis:String[]
Position:0
Nilai default:None
Diperlukan:True
Terima input alur:True
Terima karakter wildcard:True

-Scope

Hanya mendapatkan variabel dalam cakupan yang ditentukan. Nilai yang dapat diterima untuk parameter ini adalah:

  • Global
  • Lokal
  • Skrip
  • Angka relatif terhadap cakupan saat ini (0 melalui jumlah cakupan, di mana 0 adalah cakupan saat ini dan 1 adalah induknya)

Lokal adalah default. Untuk informasi selengkapnya, lihat about_Scopes.

Jenis:String
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
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

PSVariable

Anda dapat menyalurkan objek variabel ke cmdlet ini.

Output

None

Cmdlet ini tidak mengembalikan output.

Catatan

Windows PowerShell menyertakan alias berikut untuk Remove-Variable:

  • rv

  • Perubahan hanya memengaruhi cakupan saat ini, seperti sesi. Untuk menghapus variabel dari semua sesi, tambahkan Remove-Variable perintah ke profil PowerShell Anda.