Remove-CimSession
Usuwa co najmniej jedną sesję modelu CIM.
Składnia
CimSessionSet (domyślnie)
Remove-CimSession
[-CimSession] <CimSession[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
ComputerNameSet
Remove-CimSession
[-ComputerName] <String[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
SessionIdSet
Remove-CimSession
[-Id] <UInt32[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
InstanceIdSet
Remove-CimSession
-InstanceId <Guid[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
NameSet
Remove-CimSession
-Name <String[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Opis
Polecenie cmdlet Remove-CimSession usuwa co najmniej jeden obiekt sesji ciM z lokalnej sesji programu PowerShell.
Przykłady
Przykład 1: Usuń wszystkie sesje CIM
Get-CimSession | Remove-CimSession
To polecenie pobiera wszystkie dostępne sesje modelu CIM na komputerze lokalnym przy użyciu polecenia cmdlet Get-CimSession, a następnie usuwa je przy użyciu Remove-CimSession.
Przykład 2. Usuwanie określonej sesji modelu CIM
Remove-CimSession -Id 5
To polecenie usuwa sesję modelu CIM, która ma wartość identyfikatora 5.
Przykład 3: Pokaż listę sesji CIM do usunięcia przy użyciu parametru WhatIf
Remove-CimSession -Name a* -WhatIf
To polecenie używa wspólnego parametru WhatIf, aby określić, że usunięcie nie powinno zostać wykonane, ale tylko dane wyjściowe, co się stanie, gdyby zostało zrobione.
Parametry
-CimSession
Określa obiekty sesji programu CIM do zamknięcia.
Wprowadź zmienną zawierającą sesję modelu CIM lub polecenie, które tworzy lub pobiera sesję modelu CIM, na przykład polecenia cmdlet New-CimSession lub Get-CimSession.
Aby uzyskać więcej informacji, zobacz about_CimSessions.
Właściwości parametru
| Typ: | CimSession[] |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
CimSessionSet
| Position: | 0 |
| Obowiązkowe: | True |
| Wartość z potoku: | True |
| Wartość z potoku według nazwy właściwości: | True |
| Wartość z pozostałych argumentów: | False |
-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: | True |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | True |
| Wartość z pozostałych argumentów: | False |
-Confirm
Prosi o potwierdzenie przed uruchomieniem cmdletu.
Właściwości parametru
| Typ: | SwitchParameter |
| Domyślna wartość: | False |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
| Aliasy: | por |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowe: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-Id
Określa identyfikator sesji CIM do usunięcia. Określ co najmniej jeden identyfikator rozdzielony przecinkami lub użyj 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 identyfikator wystąpienia sesji CIM do usunięcia.
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 instanceId 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
Określa nazwę przyjazną sesji CIM, którą należy usunąć. Można użyć symboli wieloznacznych z tym parametrem.
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 |
-WhatIf
Pokazuje, co się stanie, jeśli polecenie cmdlet zostanie uruchomione. Cmdlet nie jest uruchomiony.
Właściwości parametru
| Typ: | SwitchParameter |
| Domyślna wartość: | False |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
| Aliasy: | Wi |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowe: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| 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
To polecenie cmdlet nie akceptuje żadnych obiektów wejściowych.
Dane wyjściowe
Object
Cmdlet zwraca obiekt zawierający informacje o sesji CIM.