Remove-CimInstance

Синтаксис

CimInstanceComputerSet (по умолчанию)

Remove-CimInstance
    [-InputObject] <CimInstance>
    [-ResourceUri <Uri>]
    [-ComputerName <String[]>]
    [-OperationTimeoutSec <UInt32>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

CimInstanceSessionSet

Remove-CimInstance
    [-InputObject] <CimInstance>
    -CimSession <CimSession[]>
    [-ResourceUri <Uri>]
    [-OperationTimeoutSec <UInt32>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

QuerySessionSet

Remove-CimInstance
    [[-Namespace] <String>]
    [-Query] <String>
    -CimSession <CimSession[]>
    [-OperationTimeoutSec <UInt32>]
    [-QueryDialect <String>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

QueryComputerSet

Remove-CimInstance
    [[-Namespace] <String>]
    [-Query] <String>
    [-ComputerName <String[]>]
    [-OperationTimeoutSec <UInt32>]
    [-QueryDialect <String>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Описание

Примеры

Пример 1. Удаление экземпляра CIM

Remove-CimInstance -Query 'Select * from Win32_Environment where name LIKE "testvar%"'

Пример 2. Удаление экземпляра CIM с помощью объекта экземпляра CIM

notepad.exe
$var = Get-CimInstance -Query 'Select * from Win32_Process where name LIKE "notepad%"'
Remove-CimInstance -InputObject $var

Параметры

-CimSession

Выполняет команду с помощью указанного сеанса CIM. Введите переменную, содержащую сеанс CIM, или команду, которая создает или получает сеанс CIM, например командлеты New-CimSession или Get-CimSession. Дополнительные сведения см. в разделе about_CimSession.

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

Наборы параметров

-ComputerName

Указывает имя компьютера, на котором требуется выполнить операцию CIM. Можно указать полное доменное имя (FQDN) или имя NetBIOS.

При указании этого параметра командлет создает временный сеанс для указанного компьютера с помощью протокола WsMan.

Если этот параметр не указан, командлет выполняет операцию на локальном компьютере с помощью объектной модели компонента (COM).

Если на одном компьютере выполняются несколько операций, подключение с помощью сеанса CIM обеспечивает более высокую производительность.

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

Наборы параметров

-Confirm

Запрашивает подтверждение перед запуском cmdlet.

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

Наборы параметров

-InputObject

Указывает объект экземпляра CIM, который нужно удалить с сервера CIM. Объект, переданный командлету, не изменяется, удаляется только экземпляр на сервере CIM.

Параметр InputObject не перечисляет коллекции. В случае передачи коллекции возникает ошибка. При работе с коллекциями направьте входные данные для перечисления значений.

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

Наборы параметров

-Namespace

Указывает пространство имен для операции CIM. Пространство имен по умолчанию — корневой/CIMV2. Вы можете использовать завершение вкладки для просмотра списка пространств имен, так как PowerShell получает список пространств имен с локального сервера WMI для предоставления списка пространств имен.

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

Наборы параметров

-OperationTimeoutSec

Указывает период времени, в течение которого командлет ожидает ответа от компьютера. По умолчанию значение этого параметра 0, что означает, что командлет использует значение времени ожидания по умолчанию для сервера.

Если параметр OperationTimeoutSec имеет значение меньше времени ожидания надежного повтора подключения в 3 минуты, сетевые сбои, длящиеся дольше, чем значение параметра OperationTimeoutSec, не подлежат восстановлению, так как время операции на сервере истекает до того, как клиент успевает переподключиться.

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

Наборы параметров

-Query

Указывает запрос, выполняемый на сервере CIM. Можно указать диалект запроса с помощью параметра QueryDialect.

Если указанное значение содержит двойные кавычки (), одинарные кавычки ("') или обратную косую черту (\), необходимо экранировать эти символы, префиксируя их с помощью символа обратной косой черты (\). Если указанное значение использует оператор WQL LIKE, необходимо экранировать следующие символы, заключив их в квадратные скобки ([]): процент (%), подчеркивание (_) или открытие квадратной скобки ([).

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

Наборы параметров

-QueryDialect

Указывает язык запросов, используемый для параметра query. Допустимые значения для этого параметра: WQL или CQL. Значение по умолчанию — WQL.

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

Наборы параметров

-ResourceUri

Указывает универсальный идентификатор ресурса (URI) класса ресурса или экземпляра. Универсальный код ресурса (URI) используется для определения определенного типа ресурса, например дисков или процессов на компьютере.

URI состоит из префикса и пути к ресурсу. Рассмотрим пример.

• http://schemas.microsoft.com/wbem/wsman/1/wmi/root/cimv2/Win32_LogicalDisk
• http://intel.com/wbem/wscim/1/amt-schema/1/AMT_GeneralSettings

По умолчанию, если этот параметр не указан, используется стандартный универсальный код ресурса DMTF http://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/, а имя класса добавляется к нему.

ResourceUri можно использовать только с сеансами CIM, созданными с помощью протокола WSMan, или при указании параметра ComputerName, который создает сеанс CIM с помощью WSMan. Если этот параметр указан без указания параметра ComputerName или при указании сеанса CIM, созданного с помощью протокола DCOM, возникает ошибка, так как протокол DCOM не поддерживает параметр ResourceUri.

Если заданы и параметр ResourceUri, и параметр фильтра, параметр фильтра игнорируется.

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

Наборы параметров

-WhatIf

Показывает, что произойдет, если командлет будет запущен. Командлет не запускается.

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

Наборы параметров

CommonParameters

Входные данные

None

Выходные данные

None

Примечания

Связанные ссылки

• New-CimInstance
• Get-CimInstance
• Set-CimInstance