Bagikan melalui

Remove-CimSession

  • Referensi
Modul:
CimCmdlets

Menghapus satu atau beberapa sesi CIM.

Sintaks

Remove-CimSession
      [-CimSession] <CimSession[]>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CimSession
      [-ComputerName] <String[]>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CimSession
      [-Id] <UInt32[]>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CimSession
      -InstanceId <Guid[]>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CimSession
      -Name <String[]>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Deskripsi

Cmdlet ini hanya tersedia di platform Windows.

Remove-CimSession Cmdlet menghapus satu atau beberapa objek sesi CIM dari sesi PowerShell lokal.

Contoh

Contoh 1: Hapus semua sesi CIM

Contoh ini mengambil semua sesi CIM yang tersedia di komputer lokal menggunakan cmdlet Get-CimSession , lalu menghapusnya menggunakan Remove-CimSession.

Get-CimSession | Remove-CimSession

Contoh 2: Menghapus sesi CIM tertentu

Contoh ini menghapus sesi CIM yang memiliki nilai Id 5.

Remove-CimSession -Id 5

Contoh 3: Menampilkan daftar sesi CIM yang akan dihapus dengan menggunakan parameter WhatIf

Contoh ini menggunakan parameter umum WhatIf untuk menentukan bahwa penghapusan tidak boleh dilakukan, tetapi hanya menghasilkan apa yang akan terjadi jika dilakukan.

Remove-CimSession -Name a* -WhatIf

Parameter

-CimSession

Menentukan objek sesi sesi CIM untuk ditutup.

Masukkan variabel yang berisi sesi CIM, atau perintah yang membuat atau mendapatkan sesi CIM, seperti New-CimSession cmdlet atau Get-CimSession . Untuk informasi selengkapnya, lihat about_CimSessions.

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

-ComputerName

Menentukan array nama komputer. Menghapus sesi yang tersambung ke komputer yang ditentukan. Anda dapat menentukan nama domain yang sepenuhnya memenuhi syarat (FQDN) atau nama NetBIOS.

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

-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

-Id

Menentukan ID sesi CIM yang akan dihapus. Tentukan satu atau beberapa ID yang dipisahkan oleh koma, atau gunakan operator rentang (..) untuk menentukan rentang ID. Id adalah bilangan bulat yang secara unik mengidentifikasi sesi CIM dalam sesi PowerShell saat ini.

Untuk informasi selengkapnya tentang operator rentang, lihat about_Operators.

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

-InstanceId

Menentukan ID instans sesi CIM yang akan dihapus. InstanceId adalah Pengidentifikasi Unik Global (GUID) yang secara unik mengidentifikasi sesi CIM. InstanceId unik, bahkan ketika Anda memiliki beberapa sesi yang berjalan di PowerShell.

InstanceId disimpan di properti InstanceId objek yang mewakili sesi CIM.

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

-Name

Menentukan nama yang mudah diingat dari sesi CIM yang akan dihapus. Anda dapat menggunakan karakter kartubebas dengan parameter ini.

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

-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

None

Anda tidak dapat menyalurkan objek ke cmdlet ini.

Output

Object

Cmdlet ini mengembalikan objek yang berisi informasi sesi CIM.

Catatan

PowerShell menyertakan alias berikut untuk Remove-CimSession:

  • Windows:
    • rcms

Cmdlet ini hanya tersedia di platform Windows.