Remove-CimSession
Удаляет один или несколько сеансов CIM.
Синтаксис
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>]
Описание
Этот командлет доступен только на платформе Windows.
Командлет Remove-CimSession
удаляет один или несколько объектов сеанса CIM из локального сеанса PowerShell.
Примеры
Пример 1. Удаление всех сеансов CIM
В этом примере извлекаются все доступные сеансы CIM на локальном компьютере с помощью командлета Get-CimSession , а затем удаляются с помощью Remove-CimSession
.
Get-CimSession | Remove-CimSession
Пример 2. Удаление определенного сеанса CIM
В этом примере удаляется сеанс CIM со значением идентификатора 5.
Remove-CimSession -Id 5
Пример 3. Отображение списка сеансов CIM для удаления с помощью параметра WhatIf
В этом примере используется общий параметр WhatIf , чтобы указать, что удаление не должно выполняться, а выводится только то, что произойдет в этом случае.
Remove-CimSession -Name a* -WhatIf
Параметры
-CimSession
Указывает объекты сеанса сеансов сеансов CIM, которые необходимо закрыть.
Введите переменную, содержащую сеанс CIM, или команду, которая создает или получает сеанс CIM, например New-CimSession
командлеты или Get-CimSession
.
Дополнительные сведения см. в разделе about_CimSessions.
Type: | CimSession[] |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ComputerName
Задает массив имен компьютеров. Удаляет сеансы, которые подключаются к указанным компьютерам. Можно указать полное доменное имя (FQDN) или NetBIOS-имя.
Type: | String[] |
Aliases: | CN, ServerName |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | True |
-Confirm
Запрос подтверждения перед выполнением командлета.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Id
Указывает идентификатор удаляемого сеанса CIM. Укажите один или несколько идентификаторов, разделенных запятыми, или используйте оператор диапазона (..
) для указания диапазона идентификаторов. Идентификатор — это целое число, которое однозначно идентифицирует сеанс CIM в текущем сеансе PowerShell.
Дополнительные сведения об операторе range см. в разделе about_Operators.
Type: | UInt32[] |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-InstanceId
Указывает идентификатор экземпляра удаляемого сеанса CIM. InstanceId — это глобальный уникальный идентификатор (GUID), который однозначно идентифицирует сеанс CIM. InstanceId является уникальным, даже если в PowerShell выполняется несколько сеансов.
InstanceId хранится в свойстве InstanceId объекта, представляющего сеанс CIM.
Type: | Guid[] |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Name
Указывает понятное имя удаляемого сеанса CIM. С этим параметром можно использовать подстановочные знаки.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | True |
-WhatIf
Показывает, что произойдет при запуске командлета. Командлет не выполняется.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Входные данные
None
Вы не можете передавать объекты в этот командлет.
Выходные данные
Этот командлет возвращает объект , содержащий сведения о сеансе CIM.
Примечания
PowerShell включает следующие псевдонимы для Remove-CimSession
:
- Windows:
rcms
Этот командлет доступен только на платформах Windows.