Remove-CimSession
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
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
Cmdlet ini mengembalikan objek yang berisi informasi sesi CIM.