Udostępnij za pośrednictwem

Get-CimSession

  • Odwołanie
Moduł:
CimCmdlets

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 polecenie cmdlet pobiera wszystkie sesje ciągłej integracji utworzone w bieżącej sesji programu PowerShell. Możesz użyć parametrów , Get-CimSession aby pobrać sesje, które są dla określonych komputerów, lub można zidentyfikować sesje według ich nazw lub innych identyfikatorów. Get-CimSession program nie pobiera sesji modelu CIM utworzonych w innych sesjach programu PowerShell lub utworzonych na innych komputerach.

Aby uzyskać więcej informacji na temat sesji modelu CIM, zobacz about_CimSession.

Przykłady

Przykład 1. Pobieranie sesji modelu cim z bieżącej sesji programu PowerShell

W tym przykładzie są tworzone sesje modelu CIM przy użyciu polecenia New-CimSession, a następnie uzyskuje sesje modelu CIM przy użyciu polecenia 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 modelu ciM do określonego komputera

W tym przykładzie są pobierane sesje modelu ciM, które są 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. Pobieranie listy sesji modelu ciM, a następnie formatowanie listy

Ten przykład pobiera wszystkie sesje modelu CIM w bieżącej sesji programu PowerShell i wyświetla tabelę zawierającą tylko właściwości 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 modelu ciM, które mają określone nazwy

Ten przykład pobiera 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. Uzyskiwanie określonej sesji modelu CIM

W tym przykładzie jest pobierana sesja modelu CIM o identyfikatorze 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 w celu uzyskania połączonych sesji modelu cim. Dozwolone są symbole 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 modelu CIM do pobrania. 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 jednoznacznie identyfikuje sesję modelu ciągłej integracji w bieżącej sesji programu 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 to unikatowy identyfikator globalny (GUID), który jednoznacznie identyfikuje sesję modelu CIM. Identyfikator wystąpienia jest unikatowy, nawet jeśli masz wiele sesji uruchomionych w programie PowerShell.

Identyfikator wystąpienia jest przechowywany we właściwości InstanceId obiektu, który reprezentuje sesję modelu CIM.

Typ:Guid[]
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-Name

Pobiera co najmniej jedną sesję ciM zawierającą określone przyjazne nazwy. Dozwolone są symbole 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 polecenie cmdlet zwraca obiekt sesji modelu CIM.

Uwagi

Program PowerShell zawiera następujące aliasy dla programu Get-CimSession:

  • Windows:
    • gcms

To polecenie cmdlet jest dostępne tylko na platformach windows.