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 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ą przeznaczone dla określonych komputerów, lub można zidentyfikować sesje według ich nazw lub innych identyfikatorów. Get-CimSession
program nie pobiera sesji ciM utworzonych w innych sesjach programu PowerShell lub utworzonych na innych komputerach.
Aby uzyskać więcej informacji na temat sesji ciM, zobacz about_CimSession.
Przykłady
Przykład 1. Pobieranie sesji ciągłej integracji z bieżącej sesji programu PowerShell
W tym przykładzie są tworzone sesje ciM przy użyciu polecenia New-CimSession, a następnie pobiera sesje 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 ciągłej integracji 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 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
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. Uzyskiwanie określonej sesji ciągłej integracji
W tym przykładzie jest pobierana sesja ciągłej integracji 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, z do których mają być podłączone sesje ciM. Dozwolone są symbole wieloznaczne.
Type: | String[] |
Aliases: | CN, ServerName |
Position: | 0 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | True |
-Id
Określa identyfikator sesji 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ę ciM w bieżącej sesji programu PowerShell.
Aby uzyskać więcej informacji na temat operatora zakresu, zobacz about_Operators.
Type: | UInt32[] |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-InstanceId
Określa identyfikatory wystąpień sesji ciM do pobrania.
InstanceId to globalnie unikatowy identyfikator (GUID), który jednoznacznie identyfikuje sesję ciM. Identyfikator InstanceId jest unikatowy, nawet jeśli masz wiele sesji uruchomionych w programie PowerShell.
Identyfikator InstanceId jest przechowywany we właściwości InstanceId obiektu, który reprezentuje sesję CIM.
Type: | Guid[] |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Name
Pobiera co najmniej jedną sesję ciM zawierającą określone przyjazne nazwy. Dozwolone są symbole wieloznaczne.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | True |
Dane wejściowe
None
Nie można potokować obiektów do tego polecenia cmdlet.
Dane wyjściowe
To polecenie cmdlet zwraca obiekt sesji ciM.
Uwagi
Program PowerShell zawiera następujące aliasy dla Get-CimSession
programu :
- W systemie Windows:
gcms
To polecenie cmdlet jest dostępne tylko na platformach systemu Windows.