Invoke-WmiMethod

Синтаксис

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

Invoke-WmiMethod
    [-Class] <String>
    [-Name] <String>
    [-ArgumentList <Object[]>]
    [-AsJob]
    [-Impersonation <ImpersonationLevel>]
    [-Authentication <AuthenticationLevel>]
    [-Locale <String>]
    [-EnableAllPrivileges]
    [-Authority <String>]
    [-Credential <PSCredential>]
    [-ThrottleLimit <Int32>]
    [-ComputerName <String[]>]
    [-Namespace <String>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

object

Invoke-WmiMethod
    [-Name] <String>
    -InputObject <ManagementObject>
    [-ArgumentList <Object[]>]
    [-AsJob]
    [-ThrottleLimit <Int32>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

path

Invoke-WmiMethod
    [-Name] <String>
    -Path <String>
    [-ArgumentList <Object[]>]
    [-AsJob]
    [-Impersonation <ImpersonationLevel>]
    [-Authentication <AuthenticationLevel>]
    [-Locale <String>]
    [-EnableAllPrivileges]
    [-Authority <String>]
    [-Credential <PSCredential>]
    [-ThrottleLimit <Int32>]
    [-ComputerName <String[]>]
    [-Namespace <String>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

WQLQuery

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

query

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

list

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

Описание

Примеры

Пример 1. Перечисление требуемого порядка параметров метода WMI

Get-WmiObject Win32_Volume |
    Get-Member -MemberType Method -Name Format |
    Select-Object -ExpandProperty Definition

System.Management.ManagementBaseObject Format(System.String FileSystem, System.Boolean QuickFormat,
 System.UInt32 ClusterSize, System.String Label, System.Boolean EnableCompression,
 System.UInt32 Version)

Пример 2. Запуск экземпляра приложения

([wmiclass]'Win32_Process').Create.OverloadDefinitions

System.Management.ManagementBaseObject Create(System.String CommandLine, System.String CurrentDirectory,
 System.Management.ManagementObject#Win32_ProcessStartup ProcessStartupInformation)

Invoke-WmiMethod -Path Win32_Process -Name Create -ArgumentList C:\Windows\system32\notepad.exe

__GENUS          : 2
__CLASS          : __PARAMETERS
__SUPERCLASS     :
__DYNASTY        : __PARAMETERS
__RELPATH        :
__PROPERTY_COUNT : 2
__DERIVATION     : {}
__SERVER         :
__NAMESPACE      :
__PATH           :
ProcessId        : 11312
ReturnValue      : 0
PSComputerName   :

Пример 3. Переименование файла

$invokeWmiMethodSplat = @{
    Path = "CIM_DataFile.Name='C:\scripts\test.txt'"
    Name = 'Rename'
    ArgumentList = 'C:\scripts\test_bu.txt'
}
Invoke-WmiMethod @invokeWmiMethodSplat

__GENUS          : 2
__CLASS          : __PARAMETERS
__SUPERCLASS     :
__DYNASTY        : __PARAMETERS
__RELPATH        :
__PROPERTY_COUNT : 1
__DERIVATION     : {}
__SERVER         :
__NAMESPACE      :
__PATH           :
ReturnValue      : 0

Пример 4. Передача массива значений с помощью "-ArgumentList"

$acl = Get-Acl test.txt
$binSD = $acl.GetSecurityDescriptorBinaryForm()
$invokeWmiMethodSplat = @{
    Class = 'Win32_SecurityDescriptorHelper'
    Name = 'BinarySDToSDDL'
    ArgumentList = $binSD, $null
}
Invoke-WmiMethod @invokeWmiMethodSplat

Параметры

-ArgumentList

Задает параметры, передаваемые в вызываемой метод. Значение этого параметра должно быть массивом объектов, и они должны отображаться в порядке, необходимом для вызываемого метода. Командлет Invoke-CimCommand не имеет этих ограничений.

Чтобы определить порядок перечисления этих объектов, выполните метод GetMethodParameters() в классе WMI, как показано в примере 1, в конце этого раздела.

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

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

-AsJob

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

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

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

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

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

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

-Authentication

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

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

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

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

-Authority

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

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

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

-Class

Указывает класс WMI, содержащий статический метод для вызова.

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

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

-ComputerName

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

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

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

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

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

-Confirm

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

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

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

-Credential

Указывает учетную запись пользователя, которая имеет разрешение на выполнение этого действия. По умолчанию используется текущий пользователь. Введите имя пользователя, например User01, Domain01\User01или [email protected]. Или введите объект PSCredential, например объект, возвращаемый командлетом Get-Credential. При вводе имени пользователя вам будет предложено ввести пароль.

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

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

-EnableAllPrivileges

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

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

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

-Impersonation

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

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

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

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

-InputObject

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

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

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

-Locale

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

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

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

-Name

Указывает имя вызываемого метода. Этот параметр является обязательным и не может быть пустым или пустым.

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

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

-Namespace

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

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

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

-Path

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

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

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

-ThrottleLimit

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

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

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

-WhatIf

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

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

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

CommonParameters

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

None

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

None

Примечания

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

• Get-WSManInstance
• Invoke-WSManAction
• New-WSManInstance
• Remove-WSManInstance
• Get-WmiObject
• Remove-WmiObject
• Set-WmiInstance