Поделиться через


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для получения дополнительной информации.

Свойства параметра

Тип:

CimSession[]

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.