Udostępnij za pośrednictwem

Remove-CimSession

  • Odwołanie
Moduł:
CimCmdlets

Usuwa co najmniej jedną sesję modelu CIM.

Składnia

Remove-CimSession
      [-CimSession] <CimSession[]>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CimSession
      [-ComputerName] <String[]>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CimSession
      [-Id] <UInt32[]>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CimSession
      -InstanceId <Guid[]>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CimSession
      -Name <String[]>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Opis

To polecenie cmdlet jest dostępne tylko na platformie Windows.

Polecenie cmdlet Remove-CimSession usuwa co najmniej jeden obiekt sesji ciM z lokalnej sesji programu PowerShell.

Przykłady

Przykład 1: Usuwanie wszystkich sesji modelu ciM

Ten przykład 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.

Get-CimSession | Remove-CimSession

Przykład 2. Usuwanie określonej sesji modelu CIM

W tym przykładzie usunięto sesję modelu CIM z wartością identyfikatora 5.

Remove-CimSession -Id 5

Przykład 3. Wyświetlanie listy sesji modelu CIM do usunięcia przy użyciu parametru WhatIf

W tym przykładzie użyto 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 wykonane.

Remove-CimSession -Name a* -WhatIf

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.

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

-ComputerName

Określa tablicę nazw komputerów. Usuwa sesje łączące się z określonymi komputerami. Można określić w pełni kwalifikowaną nazwę domeny (FQDN) lub nazwę NetBIOS.

Typ:String[]
Aliasy:CN, ServerName
Position:0
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:True

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

Typ:SwitchParameter
Aliasy:cf
Position:Named
Domyślna wartość:False
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych: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 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 identyfikator wystąpienia sesji ciągłej integracji do usunięcia. InstanceId to unikatowy identyfikator globalny (GUID), który jednoznacznie identyfikuje sesję modelu 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ącej sesję modelu ciM.

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

-Name

Określa przyjazną nazwę sesji modelu CIM do usunięcia. Można użyć symboli wieloznacznych z tym parametrem.

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

-WhatIf

Pokazuje, co się stanie, jeśli polecenie cmdlet zostanie uruchomione. Polecenie cmdlet nie jest uruchamiane.

Typ:SwitchParameter
Aliasy:wi
Position:Named
Domyślna wartość:False
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

Dane wejściowe

None

Nie można potokować obiektów do tego polecenia cmdlet.

Dane wyjściowe

Object

To polecenie cmdlet zwraca obiekt zawierający informacje o sesji modelu CIM.

Uwagi

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

  • Windows:
    • rcms

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