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.

Type:CimSession[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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.

Type:String[]
Aliases:CN, ServerName
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:True

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:UInt32[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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.

Type:Guid[]
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Name

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

Type:String[]
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:True

-WhatIf

Pokazuje, co się stanie po uruchomieniu polecenia cmdlet. Polecenie cmdlet nie zostało uruchomione.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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.