Get-CimSession
Geçerli oturumdan CIM oturum nesnelerini alır.
Sözdizimi
ComputerNameSet EnterprisePublishing
Get-CimSession
[[-ComputerName] <String[]>]
[<CommonParameters>]
SessionIdSet
Get-CimSession
[-Id] <UInt32[]>
[<CommonParameters>]
InstanceIdSet
Get-CimSession
-InstanceId <Guid[]>
[<CommonParameters>]
NameSet
Get-CimSession
-Name <String[]>
[<CommonParameters>]
Description
Bu cmdlet yalnızca Windows platformunda kullanılabilir.
Varsayılan olarak, cmdlet geçerli PowerShell oturumunda oluşturulan tüm CIM oturumlarını alır. Belirli bilgisayarlara yönelik oturumları almak için Get-CimSession parametrelerini kullanabilir veya oturumları adlarına veya diğer tanımlayıcılarına göre tanımlayabilirsiniz.
Get-CimSession, diğer PowerShell oturumlarında oluşturulmuş veya diğer bilgisayarlarda oluşturulmuş CIM oturumlarını almaz.
CIM oturumları hakkında daha fazla bilgi için bkz. about_CimSession.
Örnekler
Örnek 1: Geçerli PowerShell oturumundan CIM oturumlarını alma
Bu örnekte, New-CimSessionkullanılarak CIM oturumları oluşturuluyor ve ardından Get-CimSessionkullanılarak CIM oturumları getiriliyor.
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
Örnek 2: CIM oturumlarını belirli bir bilgisayara alma
Bu örnek, Server02adlı bilgisayara bağlı CIM oturumlarını alır.
Get-CimSession -ComputerName Server02
Id : 2
Name : CimSession2
InstanceId : c0095981-52c5-4e7f-a5bb-c4c680541710
ComputerName : Server02
Protocol : WSMAN
Örnek 3: CIM oturumlarının listesini alma ve ardından listeyi biçimlendirme
Bu örnek, geçerli PowerShell oturumundaki tüm CIM oturumlarını alır ve yalnızca ComputerName ve InstanceId özelliklerini içeren bir tablo görüntüler.
Get-CimSession | Format-Table -Property ComputerName, InstanceId
ComputerName InstanceId
------------ ----------
Server01 d1413bc3-162a-4cb8-9aec-4d2c61253d59
Server02 c0095981-52c5-4e7f-a5bb-c4c680541710
Örnek 4: Belirli adlara sahip tüm CIM oturumlarını alma
Bu örnek, Servile başlayan adlara sahip tüm CIM oturumlarını alır.
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
Örnek 5: Belirli bir CIM oturumu alma
Bu örnek, 2 Kimliği olan CIM oturumunu alır.
Get-CimSession -Id 2
Id : 2
Name : CimSession2
InstanceId : c0095981-52c5-4e7f-a5bb-c4c680541710
ComputerName : Server02
Protocol : WSMAN
Parametreler
-ComputerName
CIM oturumlarının bağlanacak bilgisayarın adını belirtir. Joker karakterlere izin verilir.
Parametre özellikleri
| Tür: | String[] |
| Default value: | None |
| Joker karakterleri destekler: | True |
| DontShow: | False |
| Diğer adlar: | Çin, SunucuAdı |
Parametre kümeleri
ComputerNameSet
| Position: | 0 |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | True |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-Id
Alınacak CIM oturumunun tanımlayıcısını belirtir. Birden çok kimlik için, kimlikleri ayırmak için virgül kullanın veya bir kimlik aralığı belirtmek için aralık işlecini (..) kullanın.
Kimliği, mevcut PowerShell oturumunda CIM oturumunu benzersiz bir şekilde tanımlayan bir tamsayıdır.
Daha fazla bilgi için aralık işleci hakkında bkz. about_Operators.
Parametre özellikleri
| Tür: | UInt32[] |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
SessionIdSet
| Position: | 0 |
| Zorunlu: | True |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | True |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-InstanceId
Alınacak CIM oturumunun örnek kimliklerini belirtir.
InstanceId, CIM oturumunu benzersiz olarak tanımlayan genel olarak benzersiz bir tanımlayıcıdır (GUID). InstanceId, PowerShell'de çalışan birden çok oturuma sahip olsanız bile benzersizdir.
InstanceId, CIM oturumunu temsil eden nesnenin InstanceId özelliğinde depolanır.
Parametre özellikleri
| Tür: | Guid[] |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
InstanceIdSet
| Position: | Named |
| Zorunlu: | True |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | True |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-Name
Belirtilen tanıdık adları içeren bir veya daha fazla CIM oturumu alır. Joker karakterlere izin verilir.
Parametre özellikleri
| Tür: | String[] |
| Default value: | None |
| Joker karakterleri destekler: | True |
| DontShow: | False |
Parametre kümeleri
NameSet
| Position: | Named |
| Zorunlu: | True |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | True |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
CommonParameters
Bu cmdlet yaygın parametreleri destekler: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction ve -WarningVariable. Daha fazla bilgi için bkz. about_CommonParameters.
Girişler
None
Nesneleri bu cmdlet'e yöneltemezsiniz.
Çıkışlar
CimSession
Bu cmdlet bir CIM oturum nesnesi döndürür.
Notlar
PowerShell, Get-CimSessioniçin aşağıdaki diğer adları içerir:
- Windows:
gcms
Bu cmdlet yalnızca Windows platformlarında kullanılabilir.