Get-CimSession
Pobiera obiekty sesji CIM z bieżącej sesji.
Składnia
Get-CimSession
[[-ComputerName] <String[]>]
[<CommonParameters>]
Get-CimSession
[-Id] <UInt32[]>
[<CommonParameters>]
Get-CimSession
-InstanceId <Guid[]>
[<CommonParameters>]
Get-CimSession
-Name <String[]>
[<CommonParameters>]
Opis
To polecenie cmdlet jest dostępne tylko na platformie Windows.
Domyślnie cmdlet pobiera wszystkie sesje CIM utworzone w bieżącej sesji programu PowerShell. Możesz użyć parametrów Get-CimSession
, aby pobrać sesje dla określonych komputerów lub zidentyfikować sesje według ich nazw lub innych identyfikatorów.
Get-CimSession
nie pobiera sesji CIM, które zostały utworzone w innych sesjach PowerShell lub zostały utworzone na innych komputerach.
Aby uzyskać więcej informacji na temat sesji CIM, zobacz about_CimSession.
Przykłady
Przykład 1. Pobieranie sesji CIM w bieżącej sesji programu PowerShell
W tym przykładzie są tworzone sesje CIM przy użyciu New-CimSession, a następnie pobierane są sesje CIM przy użyciu 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
Przykład 2: Pobieranie sesji CIM do określonego komputera
W tym przykładzie uzyskiwane są sesje Modelu CIM aktywnie połączone z komputerem o nazwie Server02.
Get-CimSession -ComputerName Server02
Id : 2
Name : CimSession2
InstanceId : c0095981-52c5-4e7f-a5bb-c4c680541710
ComputerName : Server02
Protocol : WSMAN
Przykład 3: Pobierz listę sesji CIM, a następnie sformatuj listę
Ten przykład pobiera wszystkie sesje CIM w obecnej sesji PowerShell i wyświetla tabelę zawierającą tylko atrybuty ComputerName i InstanceID.
Get-CimSession | Format-Table -Property ComputerName, InstanceId
ComputerName InstanceId
------------ ----------
Server01 d1413bc3-162a-4cb8-9aec-4d2c61253d59
Server02 c0095981-52c5-4e7f-a5bb-c4c680541710
Przykład 4: Pobieranie wszystkich sesji CIM, które mają określone nazwy
W tym przykładzie są pobierane wszystkie sesje modelu CIM, które mają nazwy rozpoczynające się od 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
Przykład 5: Uzyskanie określonej sesji CIM
W tym przykładzie jest pobierana sesja modelu CIM z identyfikatorem 2.
Get-CimSession -ID 2
Id : 2
Name : CimSession2
InstanceId : c0095981-52c5-4e7f-a5bb-c4c680541710
ComputerName : Server02
Protocol : WSMAN
Parametry
-ComputerName
Określa nazwę komputera, aby uzyskać połączenie z sesjami CIM. Dozwolone są znaki wieloznaczne.
Typ: | String[] |
Aliasy: | CN, ServerName |
Position: | 0 |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | True |
Akceptowanie symboli wieloznacznych: | True |
-Id
Określa identyfikator sesji CIM, którą chcesz pobrać. W przypadku wielu identyfikatorów użyj przecinków, aby oddzielić identyfikatory lub użyć operatora zakresu (..
), aby określić zakres identyfikatorów. Identyfikator to liczba całkowita, która unikatowo identyfikuje sesję CIM w aktualnej sesji PowerShell.
Aby uzyskać więcej informacji na temat operatora zakresu, zobacz about_Operators.
Typ: | UInt32[] |
Position: | 0 |
Domyślna wartość: | None |
Wymagane: | True |
Akceptowanie danych wejściowych potoku: | True |
Akceptowanie symboli wieloznacznych: | False |
-InstanceId
Określa identyfikatory wystąpień sesji modelu CIM, które mają być uzyskiwane.
InstanceId jest globalnie unikatowym identyfikatorem (GUID), który jednoznacznie identyfikuje sesję CIM. InstanceId jest unikatowa, nawet jeśli masz wiele sesji uruchomionych w programie PowerShell.
InstanceId jest przechowywany we właściwości InstanceId obiektu reprezentującego sesję CIM.
Typ: | Guid[] |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | True |
Akceptowanie danych wejściowych potoku: | True |
Akceptowanie symboli wieloznacznych: | False |
-Name
Pobiera jedną lub więcej sesji CIM zawierających określone przyjazne nazwy. Dozwolone są znaki wieloznaczne.
Typ: | String[] |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | True |
Akceptowanie danych wejściowych potoku: | True |
Akceptowanie symboli wieloznacznych: | True |
Dane wejściowe
None
Nie można potokować obiektów do tego polecenia cmdlet.
Dane wyjściowe
To cmdlet zwraca obiekt sesji modelu CIM.
Uwagi
Program PowerShell zawiera następujące aliasy dla Get-CimSession
:
- Windows:
gcms
To cmdlet jest dostępne tylko na platformach Windows.