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