Remove-CimInstance
Удаляет экземпляр CIM с компьютера.
Синтаксис
Remove-CimInstance
[-ResourceUri <Uri>]
[-ComputerName <String[]>]
[-OperationTimeoutSec <UInt32>]
[-InputObject] <CimInstance>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Remove-CimInstance
-CimSession <CimSession[]>
[-ResourceUri <Uri>]
[-OperationTimeoutSec <UInt32>]
[-InputObject] <CimInstance>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Remove-CimInstance
-CimSession <CimSession[]>
[[-Namespace] <String>]
[-OperationTimeoutSec <UInt32>]
[-Query] <String>
[-QueryDialect <String>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Remove-CimInstance
[-ComputerName <String[]>]
[[-Namespace] <String>]
[-OperationTimeoutSec <UInt32>]
[-Query] <String>
[-QueryDialect <String>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Описание
Этот командлет удаляет экземпляр CIM с сервера CIM. Удаляемый экземпляр CIM можно указать с помощью объекта экземпляра CIM, полученного Get-CimInstance
командлетом, или путем указания запроса.
Если параметр InputObject не указан, командлет работает одним из следующих способов:
- Если ни параметр ComputerName, ни параметр CimSession не указаны, этот командлет работает с локальным инструментарием управления Windows (WMI) с использованием сеанса COM.
- Если указан параметр ComputerName или CimSession , то этот командлет работает с сервером CIM, указанным параметром ComputerName или параметром CimSession .
Примеры
Пример 1. Удаление экземпляра CIM
В этом примере используется параметр Query для удаления экземпляров CIM из класса с именем Win32_Environment , которые начинаются с символьной строки testvar .
Remove-CimInstance -Query 'Select * from Win32_Environment where name LIKE "testvar%"'
Пример 2. Удаление экземпляра CIM с помощью объекта экземпляра CIM
В этом примере извлекаются объекты экземпляра CIM, отфильтрованные по параметру Query , и они сохраняются в переменной с именем $var
с помощью командлета Get-CimInstance
. Затем содержимое переменной передается командлету Remove-CimInstance
, который удаляет экземпляры 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.
Type: | CimSession[] |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ComputerName
Указывает имя компьютера, на котором требуется выполнить операцию CIM. Можно указать полное доменное имя (FQDN) или NetBIOS-имя.
Если указать этот параметр, командлет создает временный сеанс на указанном компьютере с помощью протокола WsMan.
Если этот параметр не указан, командлет выполняет операцию на локальном компьютере с помощью модели COM.
Если на одном компьютере выполняется несколько операций, подключение с помощью сеанса CIM обеспечивает более высокую производительность.
Type: | String[] |
Aliases: | CN, ServerName |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
Запрос подтверждения перед выполнением командлета.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InputObject
Указывает объект экземпляра CIM, удаляемый с сервера CIM. Объект, переданный командлету, не изменяется, удаляется только экземпляр на сервере CIM.
Type: | CimInstance |
Aliases: | CimInstance |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Namespace
Задает пространство имен для операции CIM. Пространство имен по умолчанию — root/cimv2. Для просмотра списка пространств имен можно использовать завершение нажатия клавиши TAB, так как PowerShell получает список пространств имен с локального сервера WMI для предоставления списка пространств имен.
Type: | String |
Position: | 2 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-OperationTimeoutSec
Указывает время ожидания командлетом ответа от компьютера. По умолчанию значение этого параметра равно 0, что означает, что командлет использует значение времени ожидания по умолчанию для сервера.
Если для параметра OperationTimeoutSec задано значение меньше времени ожидания надежного повтора подключения в 3 минуты, сбои сети, которые длятся больше значения параметра OperationTimeoutSec , не могут быть восстановлены, так как время ожидания операции на сервере истекает до того, как клиент сможет повторно подключиться.
Type: | UInt32 |
Aliases: | OT |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Query
Указывает запрос, выполняемый на сервере CIM. Диалект запроса можно указать с помощью параметра QueryDialect .
Если указанное значение содержит двойные кавычки ("
), одинарные кавычки ('
) или обратную косую черту (\
), необходимо экранировать эти символы, префиксируя их символом обратной косой черты (\
). Если указанное значение использует оператор WQL LIKE, необходимо экранировать следующие символы, заключив их в квадратные скобки ([]
): процент (%
), подчеркивание (_
) или открывающую квадратную скобку ([
).
Type: | String |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-QueryDialect
Указывает язык запросов, используемый для параметра Query. Допустимые значения для этого параметра: WQL или CQL. Значение по умолчанию — WQL.
Type: | String |
Position: | Named |
Default value: | WQL |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ResourceUri
Указывает универсальный код ресурса (URI) класса или экземпляра ресурса. URI используется для идентификации определенного типа ресурсов, например дисков и процессов на компьютере.
URI состоит из префикса и пути к ресурсу. Пример:
https://schemas.microsoft.com/wbem/wsman/1/wmi/root/cimv2/Win32_LogicalDisk
http://intel.com/wbem/wscim/1/amt-schema/1/AMT_GeneralSettings
По умолчанию, если этот параметр не указан, используется стандартный универсальный код ресурса http://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/
DMTF и к нему добавляется имя класса.
ResourceURI можно использовать только с сеансами CIM, созданными с помощью протокола WSMan, или при указании параметра ComputerName, который создает сеанс CIM с помощью WSMan. При указании этого параметра без указания параметра ComputerName или при указании сеанса CIM, созданного с помощью протокола DCOM, возникает ошибка, так как протокол DCOM не поддерживает параметр ResourceURI.
Если указаны параметры ResourceUri и Filter , параметр Filter игнорируется.
Type: | Uri |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-WhatIf
Показывает, что произойдет при запуске командлета. Командлет не выполняется.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Входные данные
None
Этот командлет не принимает входные объекты.
Выходные данные
None
Этот командлет не создает выходные данные.