Bagikan melalui

Get-CimSession

Modul:
CimCmdlets Module

Mendapatkan objek sesi CIM dari sesi saat ini.

Sintaks

ComputerNameSet (Default) 

Get-CimSession
    [[-ComputerName] <String[]>]
    [<CommonParameters>]

SessionIdSet 

Get-CimSession
    [-Id] <UInt32[]>
    [<CommonParameters>]

InstanceIdSet 

Get-CimSession
    -InstanceId <Guid[]>
    [<CommonParameters>]

NameSet 

Get-CimSession
    -Name <String[]>
    [<CommonParameters>]

Deskripsi

Cmdlet ini hanya tersedia di platform Windows.

Secara default, cmdlet mendapatkan semua sesi CIM yang dibuat dalam sesi PowerShell saat ini. Anda dapat menggunakan parameter Get-CimSession untuk mendapatkan sesi yang untuk komputer tertentu, atau Anda dapat mengidentifikasi sesi berdasarkan namanya atau pengidentifikasi lainnya. Get-CimSession tidak mendapatkan sesi CIM yang dibuat di sesi PowerShell lainnya atau yang dibuat di komputer lain.

Untuk informasi selengkapnya tentang sesi CIM, lihat about_CimSession.

Contoh

Contoh 1: Mendapatkan sesi CIM dari sesi PowerShell saat ini

Contoh ini membuat sesi CIM menggunakan New-CimSession, kemudian mendapatkan sesi CIM menggunakan Get-CimSession.

New-CimSession -ComputerName Server01, Server02
Get-CimSession

Id           : 1
Name         : CimSession1
InstanceId   : d1413bc3-162a-4cb8-9aec-4d2c61253d59
ComputerName : Server01
Protocol     : WSMAN

Id           : 2
Name         : CimSession2
InstanceId   : c0095981-52c5-4e7f-a5bb-c4c680541710
ComputerName : Server02
Protocol     : WSMAN

Contoh 2: Mendapatkan sesi CIM ke komputer tertentu

Contoh ini menampilkan sesi CIM yang tersambung ke komputer bernama Server02.

Get-CimSession -ComputerName Server02

Id           : 2
Name         : CimSession2
InstanceId   : c0095981-52c5-4e7f-a5bb-c4c680541710
ComputerName : Server02
Protocol     : WSMAN

Contoh 3: Dapatkan daftar sesi CIM lalu format daftar

Contoh ini mendapatkan semua sesi CIM dalam sesi PowerShell saat ini dan menampilkan tabel yang hanya berisi ComputerName dan instanceId properti.

Get-CimSession | Format-Table -Property ComputerName, InstanceId

ComputerName InstanceId
------------ ----------
Server01     d1413bc3-162a-4cb8-9aec-4d2c61253d59
Server02     c0095981-52c5-4e7f-a5bb-c4c680541710

Contoh 4: Dapatkan semua sesi CIM yang memiliki nama tertentu

Contoh ini mendapatkan semua sesi CIM yang memiliki nama yang dimulai dengan Serv.

Get-CimSession -ComputerName Serv*

Id           : 1
Name         : CimSession1
InstanceId   : d1413bc-162a-4cb8-9aec-4d2c61253d59
ComputerName : Server01
Protocol     : WSMAN

Id           : 2
Name         : CimSession2
InstanceId   : c0095981-52c5-4e7f-a5bb-c4c680541710
ComputerName : Server02
Protocol     : WSMAN

Contoh 5: Mendapatkan sesi CIM tertentu

Contoh ini mendapatkan sesi CIM yang memiliki Id dari 2.

Get-CimSession -Id 2

Id           : 2
Name         : CimSession2
InstanceId   : c0095981-52c5-4e7f-a5bb-c4c680541710
ComputerName : Server02
Protocol     : WSMAN

Parameter

-ComputerName

Menentukan nama komputer untuk menyambungkan sesi CIM. Karakter pengganti diizinkan.

Properti parameter

Jenis:

String[]

Nilai default:None
Mendukung wildcard:True
DontShow:False
Alias:CN, ServerName

Set parameter

ComputerNameSet
Position:0
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:True
Nilai dari argumen yang tersisa:False

-Id

Menentukan ID sesi CIM yang ingin didapatkan. Untuk beberapa ID, gunakan koma untuk memisahkan ID atau menggunakan 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

Set 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 didapatkan.

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

Set parameter

InstanceIdSet
Position:Named
Wajib:True
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:True
Nilai dari argumen yang tersisa:False

-Name

Mendapatkan satu atau beberapa sesi CIM yang berisi nama-nama mudah diingat yang ditentukan. Karakter pengganti diizinkan.

Properti parameter

Jenis:

String[]

Nilai default:None
Mendukung wildcard:True
DontShow:False

Set parameter

NameSet
Position:Named
Wajib:True
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:True
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

CimSession

Cmdlet ini mengembalikan objek sesi CIM.

Catatan

PowerShell menyertakan alias berikut untuk Get-CimSession:

  • Windows:
    • gcms

Cmdlet ini hanya tersedia di platform Windows.