Remove-CimSession
Menghapus satu atau beberapa sesi CIM.
Sintaks
CimSessionSet (Default)
Remove-CimSession
[-CimSession] <CimSession[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
ComputerNameSet
Remove-CimSession
[-ComputerName] <String[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
SessionIdSet
Remove-CimSession
[-Id] <UInt32[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
InstanceIdSet
Remove-CimSession
-InstanceId <Guid[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
NameSet
Remove-CimSession
-Name <String[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Deskripsi
Cmdlet ini hanya tersedia di platform Windows.
Cmdlet Remove-CimSession 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
Get-CimSession | Remove-CimSession
Contoh 2: Menghapus sesi CIM tertentu
Contoh ini menghapus sesi CIM yang memiliki Id dengan nilai sebesar 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 itu dilakukan.
Remove-CimSession -Name a* -WhatIf
Parameter
-CimSession
Menentukan objek sesi CIM yang akan ditutup.
Masukkan variabel yang berisi sesi CIM, atau perintah yang membuat atau mendapatkan sesi CIM, seperti cmdlet New-CimSession atau Get-CimSession.
Untuk informasi selengkapnya, lihat about_CimSessions.
Properti parameter
| Jenis: | |
| Nilai default: | None |
| Mendukung wildcard: | False |
| DontShow: | False |
Kumpulan parameter
CimSessionSet
| Position: | 0 |
| Wajib: | True |
| Nilai dari alur: | True |
| Nilai dari alur berdasarkan nama properti: | True |
| Nilai dari argumen yang tersisa: | False |
-ComputerName
Menentukan sekumpulan nama-nama komputer. Menghapus sesi yang tersambung ke komputer yang ditentukan. Anda dapat menentukan nama domain yang sepenuhnya memenuhi syarat (FQDN) atau nama NetBIOS.
Properti parameter
| Jenis: | String[] |
| Nilai default: | None |
| Mendukung wildcard: | True |
| DontShow: | False |
| Alias: | CN, ServerName |
Kumpulan parameter
ComputerNameSet
| Position: | 0 |
| Wajib: | True |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | True |
| Nilai dari argumen yang tersisa: | False |
-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 |
-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 lebih lanjut mengenai rentang operator, lihat about_Operators.
Properti parameter
| Jenis: | UInt32[] |
| Nilai default: | None |
| Mendukung wildcard: | False |
| DontShow: | False |
Kumpulan parameter
SessionIdSet
| Position: | 0 |
| Wajib: | True |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | True |
| Nilai dari argumen yang tersisa: | False |
-InstanceId
Menentukan ID instans sesi CIM yang akan dihapus. InstanceId adalah Pengidentifikasi Unik Global (GUID) yang secara unik mengidentifikasi sesi CIM. InstanceId itu unik, bahkan ketika Anda menjalankan beberapa sesi yang sedang berjalan di PowerShell.
InstanceId disimpan dalam properti InstanceId dari objek yang mewakili sesi CIM.
Properti parameter
| Jenis: | Guid[] |
| Nilai default: | None |
| Mendukung wildcard: | False |
| DontShow: | False |
Kumpulan parameter
InstanceIdSet
| Position: | Named |
| Wajib: | True |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | True |
| Nilai dari argumen yang tersisa: | False |
-Name
Menentukan nama ramah dari sesi CIM yang akan dihapus. Anda dapat menggunakan karakter pengganti dengan parameter ini.
Properti parameter
| Jenis: | String[] |
| Nilai default: | None |
| Mendukung wildcard: | True |
| DontShow: | False |
Kumpulan parameter
NameSet
| Position: | Named |
| Wajib: | True |
| 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
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.
