Udostępnij za pośrednictwem


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

CimSession

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.