Remove-CimSession
Удаляет один или несколько сеансов CIM.
Синтаксис
CimSessionSet (по умолчанию)
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>]
Описание
Этот командлет доступен только на платформе 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для получения дополнительной информации.
Свойства параметра
Тип: | |
Default value: | None |
Поддерживаются подстановочные знаки: | False |
DontShow: | False |
Наборы параметров
CimSessionSet
Position: | 0 |
Обязательно: | True |
Значение из конвейера: | True |
Значение из конвейера по имени свойства: | True |
Значение из оставшихся аргументов: | False |
-ComputerName
Задает массив имен компьютеров. Удаляет сеансы, которые подключаются к указанным компьютерам. Можно указать полное доменное имя (FQDN) или имя NetBIOS.
Свойства параметра
Тип: | String[] |
Default value: | None |
Поддерживаются подстановочные знаки: | True |
DontShow: | False |
Aliases: | Китай, Имя сервера |
Наборы параметров
ComputerNameSet
Position: | 0 |
Обязательно: | True |
Значение из конвейера: | False |
Значение из конвейера по имени свойства: | True |
Значение из оставшихся аргументов: | False |
-Confirm
Запрашивает подтверждение перед запуском cmdlet.
Свойства параметра
Тип: | SwitchParameter |
Default value: | False |
Поддерживаются подстановочные знаки: | False |
DontShow: | False |
Aliases: | cf |
Наборы параметров
(All)
Position: | Named |
Обязательно: | False |
Значение из конвейера: | False |
Значение из конвейера по имени свойства: | False |
Значение из оставшихся аргументов: | False |
-Id
Указывает идентификатор удаляемого сеанса CIM. Укажите один или несколько идентификаторов, разделенных запятыми, или используйте оператор диапазона (..
) для указания диапазона идентификаторов. Идентификатор Id — это целое число, уникально идентифицирующее сеанс CIM в текущем сеансе PowerShell.
Дополнительные сведения об операторе диапазона можно найти в разделе about_Operators.
Свойства параметра
Тип: | UInt32[] |
Default value: | None |
Поддерживаются подстановочные знаки: | False |
DontShow: | False |
Наборы параметров
SessionIdSet
Position: | 0 |
Обязательно: | True |
Значение из конвейера: | False |
Значение из конвейера по имени свойства: | True |
Значение из оставшихся аргументов: | False |
-InstanceId
Указывает идентификатор экземпляра сеанса CIM для удаления. InstanceId — это глобальный уникальный идентификатор (GUID), который однозначно идентифицирует сеанс CIM. Экземпляр с идентификатором уникален, даже если в PowerShell запущено несколько сеансов.
InstanceId хранится в свойстве InstanceId объекта, представляющего сеанс CIM.
Свойства параметра
Тип: | Guid[] |
Default value: | None |
Поддерживаются подстановочные знаки: | False |
DontShow: | False |
Наборы параметров
InstanceIdSet
Position: | Named |
Обязательно: | True |
Значение из конвейера: | False |
Значение из конвейера по имени свойства: | True |
Значение из оставшихся аргументов: | False |
-Name
Указывает понятное имя сеанса CIM для удаления. С этим параметром можно использовать подстановочные знаки.
Свойства параметра
Тип: | String[] |
Default value: | None |
Поддерживаются подстановочные знаки: | True |
DontShow: | False |
Наборы параметров
NameSet
Position: | Named |
Обязательно: | True |
Значение из конвейера: | False |
Значение из конвейера по имени свойства: | True |
Значение из оставшихся аргументов: | False |
-WhatIf
Показывает, что произойдет, если командлет будет запущен. Командлет не запускается.
Свойства параметра
Тип: | SwitchParameter |
Default value: | False |
Поддерживаются подстановочные знаки: | False |
DontShow: | False |
Aliases: | wi |
Наборы параметров
(All)
Position: | Named |
Обязательно: | False |
Значение из конвейера: | False |
Значение из конвейера по имени свойства: | False |
Значение из оставшихся аргументов: | False |
CommonParameters
Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters.
Входные данные
None
Невозможно передать объекты в этот командлет.
Выходные данные
Object
Этот командлет возвращает объект, содержащий сведения о сеансе CIM.
Примечания
PowerShell включает следующие псевдонимы для Remove-CimSession
:
- Виндоус:
rcms
Этот командлет доступен только на платформах Windows.