Udostępnij przez

Get-CimSession

Moduł:
CimCmdlets Module

Pobiera obiekty sesji CIM z bieżącej sesji.

Składnia

ComputerNameSet (Domyślne) 

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

SessionIdSet 

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

InstanceIdSet 

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

NameSet 

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

Opis

Ten cmdlet jest dostępny 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 modelu CIM przy użyciu New-CimSession, a następnie pobiera sesje modelu 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 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 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: Uzyskanie określonej sesji CIM

W tym przykładzie pobierana jest sesja 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, do którego mają zostać połączone sesje CIM. Symbole wieloznaczne są dozwolone.

Właściwości parametrów

Typ:

String[]

Wartość domyślna:None
Wspiera dzikie karty:True
DontShow:False
Aliasy:CN, NazwaSerwera

Zbiory parametrów

ComputerNameSet
Pozycja:0
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:True
Wartość pozostałych argumentów:False

-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 programu PowerShell.

Aby uzyskać więcej informacji na temat operatora zakresu, zobacz about_Operators.

Właściwości parametrów

Typ:

UInt32[]

Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

SessionIdSet
Pozycja:0
Obowiązkowy:True
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:True
Wartość pozostałych argumentów: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.

Właściwości parametrów

Typ:

Guid[]

Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

InstanceIdSet
Pozycja:Named
Obowiązkowy:True
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:True
Wartość pozostałych argumentów:False

-Name

Pobiera jedną lub więcej sesji CIM zawierających określone przyjazne nazwy. Symbole wieloznaczne są dozwolone.

Właściwości parametrów

Typ:

String[]

Wartość domyślna:None
Wspiera dzikie karty:True
DontShow:False

Zbiory parametrów

NameSet
Pozycja:Named
Obowiązkowy:True
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:True
Wartość pozostałych argumentów:False

CommonParameters

To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.

Wejścia

None

Nie można przekazywać obiektów do tego cmdletu.

Wyjść

CimSession

To cmdlet zwraca obiekt sesji modelu CIM.

Notatki

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

  • Windows:
    • gcms

Ten cmdlet jest dostępny tylko na platformach Windows.