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 Remove-CimSession cmdlet usuwa co najmniej jeden obiekt sesji modelu 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 polecenia Remove-CimSessioncmdlet .

Get-CimSession | Remove-CimSession

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

W tym przykładzie usunięto sesję modelu CIM, która ma wartość Identyfikator 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 by się stało, gdyby zostało to zrobione.

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 New-CimSession polecenia cmdlet 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. 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.

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 po uruchomieniu polecenia cmdlet. Polecenie cmdlet nie zostało uruchomione.

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 programu Remove-CimSession:

  • Windows:
    • rcms

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