Udostępnij przez


Get-CimSession

Pobiera obiekty sesji CIM z bieżącej sesji.

Składnia

ComputerNameSet (domyślnie)

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

SessionIdSet

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

InstanceIdSet

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

NameSet

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

Opis

Polecenie cmdlet Get-CimSession pobiera obiekty sesji modelu ciM utworzone w bieżącej sesji programu PowerShell.

Jeśli nie określono żadnych parametrów, polecenie 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, identyfikatorów lub identyfikatorów wystąpień.

Aby uzyskać więcej informacji na temat sesji programu PowerShell, zobacz about_CimSession.

Przykłady

Przykład 1. Pobieranie sesji CIM w bieżącej sesji programu PowerShell

Domyślnie Get-CimSession pobiera tylko informacje o sesjach modelu wspólnych informacji, które istnieją w bieżącej sesji programu PowerShell. Get-CimSession nie pobiera sesji modelu CIM utworzonych w innych sesjach programu PowerShell lub utworzonych na innych komputerach.

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

To polecenie najpierw tworzy sesje modelu CIM przy użyciu New-CimSession, a następnie pobiera sesje modelu CIM przy użyciu Get-CimSession.

Przykład 2: Pobieranie sesji CIM do określonego komputera

Get-CimSession -ComputerName Server02
Id           : 2
Name         : CimSession2
InstanceId   : c0095981-52c5-4e7f-a5bb-c4c680541710
ComputerName : Server02
Protocol     : WSMAN

To polecenie pobiera sesje modelu ciM, które są połączone z komputerem o nazwie Server02.

Przykład 3: Pobierz listę sesji CIM, a następnie sformatuj listę

Get-CimSession | Format-Table -Property ComputerName,InstanceId
ComputerName InstanceId
------------ ----------
Server01     d1413bc3-162a-4cb8-9aec-4d2c61253d59
Server02     c0095981-52c5-4e7f-a5bb-c4c680541710

To polecenie pobiera wszystkie sesje modelu ciM w bieżącej sesji programu PowerShell, a następnie formatuje listę w tabeli zawierającej tylko właściwości ComputerName i InstanceID.

Przykład 4: Pobieranie wszystkich sesji CIM, które mają określone nazwy

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

To polecenie pobiera wszystkie sesje modelu ciM, które mają nazwy rozpoczynające się od serwowania znaków.

Przykład 5: Uzyskanie określonej sesji CIM

Get-CimSession -ID 2
Id           : 2
Name         : CimSession2
InstanceId   : c0095981-52c5-4e7f-a5bb-c4c680541710
ComputerName : Server02
Protocol     : WSMAN

To polecenie pobiera sesję modelu CIM o identyfikatorze 2.

Parametry

-ComputerName

Określa nazwę komputera, do którego mają zostać połączone sesje CIM. Symbole wieloznaczne są dozwolone.

Właściwości parametru

Typ:

String[]

Domyślna wartość:None
Obsługuje symbole wieloznaczne:True
DontShow:False
Aliasy:CN, NazwaSerwera

Zestawy parametrów

ComputerNameSet
Position:0
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:True
Wartość z pozostałych argumentów:False

-Id

Określa identyfikator (ID) sesji modelu CIM, który ma być pobierany. W przypadku co najmniej jednego identyfikatora 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ę modelu ciągłej integracji w bieżącej sesji programu PowerShell. Łatwiej jest zapamiętać i wpisać niż InstanceId, ale jest on unikatowy tylko w bieżącej sesji programu PowerShell.

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

Właściwości parametru

Typ:

UInt32[]

Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

SessionIdSet
Position:0
Obowiązkowe:True
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:True
Wartość z pozostałych argumentów:False

-InstanceId

Określa identyfikatory wystąpień sesji modelu CIM, które mają być uzyskiwane.

InstanceId to identyfikator GUID, który jednoznacznie identyfikuje sesję modelu ciągłej integracji. 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.

Właściwości parametru

Typ:

Guid[]

Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

InstanceIdSet
Position:Named
Obowiązkowe:True
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:True
Wartość z 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 parametru

Typ:

String[]

Domyślna wartość:None
Obsługuje symbole wieloznaczne:True
DontShow:False

Zestawy parametrów

NameSet
Position:Named
Obowiązkowe:True
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:True
Wartość z 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.

Dane wejściowe

None

Dane wyjściowe

CimSession