Udostępnij przez


Remove-CimSession

Usuwa jedną lub więcej sesji CIM.

Składnia

CimSessionSet (Domyślna)

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

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ę CIM, której identyfikator ma wartość 5.

Remove-CimSession -Id 5

Przykład 3: Pokaż listę sesji 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 pokazano, co by się stało, 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.

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ązkowy: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 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.

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ązkowy: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ązkowy: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 jednoznacznie identyfikuje sesję CIM 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ązkowy: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. InstanceId jest unikatowa, nawet jeśli masz wiele sesji uruchomionych w programie PowerShell.

InstanceId jest przechowywany we właściwości InstanceId obiektu reprezentującego sesję 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ązkowy: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ązkowy: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ązkowy: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

Nie można przekazywać obiektów do tego cmdletu.

Dane wyjściowe

Object

Cmdlet zwraca obiekt zawierający informacje o sesji CIM.