Remove-WmiObject

Синтаксис

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

Remove-WmiObject
    [-Class] <String>
    [-AsJob]
    [-Impersonation <ImpersonationLevel>]
    [-Authentication <AuthenticationLevel>]
    [-Locale <String>]
    [-EnableAllPrivileges]
    [-Authority <String>]
    [-Credential <PSCredential>]
    [-ThrottleLimit <Int32>]
    [-ComputerName <String[]>]
    [-Namespace <String>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

object

Remove-WmiObject
    -InputObject <ManagementObject>
    [-AsJob]
    [-ThrottleLimit <Int32>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

path

Remove-WmiObject
    -Path <String>
    [-AsJob]
    [-Impersonation <ImpersonationLevel>]
    [-Authentication <AuthenticationLevel>]
    [-Locale <String>]
    [-EnableAllPrivileges]
    [-Authority <String>]
    [-Credential <PSCredential>]
    [-ThrottleLimit <Int32>]
    [-ComputerName <String[]>]
    [-Namespace <String>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

WQLQuery

Remove-WmiObject
    [-AsJob]
    [-Impersonation <ImpersonationLevel>]
    [-Authentication <AuthenticationLevel>]
    [-Locale <String>]
    [-EnableAllPrivileges]
    [-Authority <String>]
    [-Credential <PSCredential>]
    [-ThrottleLimit <Int32>]
    [-ComputerName <String[]>]
    [-Namespace <String>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

query

Remove-WmiObject
    [-AsJob]
    [-Impersonation <ImpersonationLevel>]
    [-Authentication <AuthenticationLevel>]
    [-Locale <String>]
    [-EnableAllPrivileges]
    [-Authority <String>]
    [-Credential <PSCredential>]
    [-ThrottleLimit <Int32>]
    [-ComputerName <String[]>]
    [-Namespace <String>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

list

Remove-WmiObject
    [-AsJob]
    [-Impersonation <ImpersonationLevel>]
    [-Authentication <AuthenticationLevel>]
    [-Locale <String>]
    [-EnableAllPrivileges]
    [-Authority <String>]
    [-Credential <PSCredential>]
    [-ThrottleLimit <Int32>]
    [-ComputerName <String[]>]
    [-Namespace <String>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Описание

Примеры

Пример 1. Закрытие всех экземпляров процесса Win32

notepad
$np = Get-WmiObject -Query "select * from Win32_Process where name='notepad.exe'"
$np | Remove-WmiObject

Пример 2. Удаление папки

$a = Get-WmiObject -Query "Select * From Win32_Directory Where Name ='C:\\Test'"
$a | Remove-WmiObject

Параметры

-AsJob

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

Новые командлеты CIM, представленные в Windows PowerShell 3.0, выполняют те же задачи, что и командлеты WMI. Командлеты CIM соответствуют стандартам WS-Management (WSMan) и стандарту Common Information Model (CIM), что позволяет командлетам использовать те же методы для управления компьютерами, работающими под управлением операционной системы Windows и работающих под управлением других операционных систем. Вместо использования Remove-WmiObjectрекомендуется использовать командлет Remove-CimInstance.

При использовании параметра AsJob команда возвращает объект, представляющий фоновое задание, а затем отображает командную строку. Вы можете продолжать работать в сеансе, пока задание завершится. Если Remove-WmiObject используется для удаленного компьютера, задание создается на локальном компьютере, а результаты с удаленных компьютеров автоматически возвращаются на локальный компьютер. Чтобы управлять заданием, используйте командлеты, содержащие существительное задания (командлеты заданий). Чтобы получить результаты задания, используйте командлет Receive-Job.

Чтобы использовать этот параметр для удаленных компьютеров, локальные и удаленные компьютеры должны быть настроены для удаленного взаимодействия. Запустите Windows PowerShell с помощью параметра "Запуск от имени администратора". Дополнительные сведения см. в about_Remote_Requirements.

Дополнительные сведения о фоновых заданиях Windows PowerShell см. в about_Jobs и about_Remote_Jobs.

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

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

-Authentication

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

• -1: без изменений.
• 0: по умолчанию.
• 1: Нет. Проверка подлинности не выполнена.
• 2: Подключение. Проверка подлинности выполняется только в том случае, если клиент устанавливает связь с приложением.
• 3: вызов. Проверка подлинности выполняется только в начале каждого вызова, когда приложение получает запрос.
• 4: пакет. Проверка подлинности выполняется для всех данных, полученных от клиента.
• 5: PacketIntegrity. Все данные, передаваемые между клиентом и приложением, проходят проверку подлинности и проверяются.
• 6: PacketPrivacy. Используются свойства других уровней проверки подлинности, а все данные шифруются.

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

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

-Authority

Указывает центр, используемый для проверки подлинности подключения WMI. Можно указать стандартную проверку подлинности NTLM или Kerberos. Чтобы использовать NTLM, задайте для параметра центра значение ntlmdomain:<DomainName>, где <имя домена> определяет допустимое доменное имя NTLM. Чтобы использовать Kerberos, укажите kerberos:<DomainName>\<ServerName>. Параметр центра нельзя включить при подключении к локальному компьютеру.

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

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

-Class

Указывает имя класса WMI, который удаляет этот командлет.

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

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

-ComputerName

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

Введите имя NetBIOS, IP-адрес или полное доменное имя одного или нескольких компьютеров. Чтобы указать локальный компьютер, введите имя компьютера, точку (.) или localhost.

Этот параметр не зависит от удаленного взаимодействия Windows PowerShell. Вы можете использовать параметр ComputerName, даже если компьютер не настроен для выполнения удаленных команд.

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

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

-Confirm

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

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

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

-Credential

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

Введите имя пользователя, например User01 или Domain01\User01, или введите объект PSCredential, например объект, созданный командлетом Get-Credential. При вводе имени пользователя этот командлет запрашивает пароль.

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

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

-EnableAllPrivileges

Указывает, что этот командлет включает все разрешения текущего пользователя перед командой, которая выполняет вызов WMI.

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

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

-Impersonation

Указывает используемый уровень олицетворения. Допустимые значения для этого параметра:

• 0: по умолчанию. Считывает локальный реестр для уровня олицетворения по умолчанию, который обычно имеет значение 3: олицетворение.
• 1: анонимный. Скрывает учетные данные вызывающего объекта.
• 2: определение. Позволяет объектам запрашивать учетные данные вызывающего объекта.
• 3: олицетворения. Позволяет объектам использовать учетные данные вызывающего объекта.
• 4: Делегат. Позволяет объектам разрешать другим объектам использовать учетные данные вызывающего объекта.

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

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

-InputObject

Указывает объект ManagementObject, используемый в качестве входных данных. При использовании этого параметра все остальные параметры игнорируются.

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

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

-Locale

Задает предпочтительный языковой стандарт для объектов WMI. Параметр языкового стандарта указан как массив в формате LCID< MS_>LCID в предпочтительном порядке.

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

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

-Namespace

Указывает пространство имен репозитория WMI, где указанный класс WMI находится при использовании с параметром класса.

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

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

-Path

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

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

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

-ThrottleLimit

Указывает максимальное количество одновременных подключений, которые можно установить для выполнения этой команды. Этот параметр используется вместе с параметром AsJob. Ограничение регулирования применяется только к текущей команде, а не к сеансу или к компьютеру.

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

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

-WhatIf

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

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

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

CommonParameters

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

ManagementObject

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

None, System.Management.Automation.RemotingJob

Примечания

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

• Get-WmiObject
• Invoke-WmiMethod
• Set-WmiInstance