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.

Type:CimSession[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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.

Type:String[]
Aliases:CN, ServerName
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:True

-Confirm

Meminta Anda mengonfirmasi sebelum menjalankan cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:UInt32[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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.

Type:Guid[]
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Name

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

Type:String[]
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:True

-WhatIf

Menunjukkan apa yang akan terjadi jika cmdlet berjalan. Cmdlet tidak dijalankan.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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.