Invoke-WSManAction

Ссылка

Модуль:: Microsoft.WSMan.Management

Вызывает действие для объекта, указанного в URI ресурса и селекторах.

Синтаксис

Invoke-WSManAction
      [-Action] <String>
      [-ConnectionURI <Uri>]
      [-FilePath <String>]
      [-OptionSet <Hashtable>]
      [[-SelectorSet] <Hashtable>]
      [-SessionOption <SessionOption>]
      [-ValueSet <Hashtable>]
      [-ResourceURI] <Uri>
      [-Credential <PSCredential>]
      [-Authentication <AuthenticationMechanism>]
      [-CertificateThumbprint <String>]
      [<CommonParameters>]

Invoke-WSManAction
      [-Action] <String>
      [-ApplicationName <String>]
      [-ComputerName <String>]
      [-FilePath <String>]
      [-OptionSet <Hashtable>]
      [-Port <Int32>]
      [[-SelectorSet] <Hashtable>]
      [-SessionOption <SessionOption>]
      [-UseSSL]
      [-ValueSet <Hashtable>]
      [-ResourceURI] <Uri>
      [-Credential <PSCredential>]
      [-Authentication <AuthenticationMechanism>]
      [-CertificateThumbprint <String>]
      [<CommonParameters>]

Описание

Выполняет Invoke-WSManAction действие для объекта, указанного RESOURCE_URI, где параметры задаются парами значений ключей.

Для выполнения действия этот командлет использует соединение/транспортный уровень WS-Management.

Примеры

Пример 1. Вызов метода

Invoke-WSManAction -Action startservice -ResourceURI wmicimv2/win32_service  -SelectorSet @{name="spooler"} -Authentication default

xsi         : http://www.w3.org/2001/XMLSchema-instance
p           : http://schemas.microsoft.com/wbem/wsman/1/wmi/root/cimv2/Win32_Service
cim         : http://schemas.dmtf.org/wbem/wscim/1/common
lang        : en-US
ReturnValue : 0

Эта команда вызывает метод StartService экземпляра класса WMI Win32_Service, соответствующий службе очереди печати.

Возвращаемое значение указывает, было ли действие успешным. В данном случае возвращаемое значение 0 указывает на успешное выполнение. Возвращаемое значение 5 указывает на то, что служба уже запущена.

Пример 2. Вызов метода

Invoke-WSManAction -Action stopservice -ResourceURI wmicimv2/Win32_Service -SelectorSet @{Name="spooler"} -FilePath:input.xml -Authentication default

xsi         : http://www.w3.org/2001/XMLSchema-instance
p           : http://schemas.microsoft.com/wbem/wsman/1/wmi/root/cimv2/Win32_Service
cim         : http://schemas.dmtf.org/wbem/wscim/1/common
lang        : en-US
ReturnValue : 0

Эта команда вызывает метод StopService в службе spooler с помощью входных данных из файла. Файл содержит Input.xmlследующее содержимое:

<p:StopService_INPUT xmlns:p="http://schemas.microsoft.com/wbem/wsman/1/wmi/root/cimv2/Win32_Service" />

Пример 3. Вызов метода с указанными значениями параметров

Invoke-WSManAction -Action create -ResourceURI wmicimv2/win32_process -ValueSet @{commandline="notepad.exe";currentdirectory="C:\"}

xsi         : http://www.w3.org/2001/XMLSchema-instance
p           : http://schemas.microsoft.com/wbem/wsman/1/wmi/root/cimv2/Win32_Process
cim         : http://schemas.dmtf.org/wbem/wscim/1/common
lang        : en-US
ProcessId   : 6356
ReturnValue : 0

Эта команда вызывает метод Create класса Win32_Process. Он передает два значения параметра метода и Notepad.exe C:\. В результате создается новый процесс для запуска Блокнота, а текущий каталог нового процесса имеет значение C:\.

Пример 4. Вызов метода на удаленном компьютере

Invoke-WSManAction -Action startservice -ResourceURI wmicimv2/win32_service  -SelectorSet @{name="spooler"} -ComputerName server01 -Authentication default

xsi         : http://www.w3.org/2001/XMLSchema-instance
p           : http://schemas.microsoft.com/wbem/wsman/1/wmi/root/cimv2/Win32_Service
cim         : http://schemas.dmtf.org/wbem/wscim/1/common
lang        : en-US
ReturnValue : 0

Эта команда вызывает метод StartService экземпляра класса WMI Win32_Service, соответствующий службе очереди печати. Поскольку указан параметр ComputerName, команда выполняется для удаленного компьютера server01.

Параметры

-Action

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

Тип:	String
Position:	1
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-ApplicationName

Указывает имя приложения в соединении. Значение по умолчанию для параметра ApplicationName — WSMAN. Полный идентификатор для удаленной конечной точки имеет следующий формат:

<Transport>://<Server>:<Port>/<ApplicationName>

Например:

http://server01:8080/WSMAN

Службы IIS, где размещен сеанс, перенаправляют запросы с этой конечной точки в заданное приложение. Этот параметр по умолчанию WSMAN подходит для большинства задач. Он предназначен для использования в ситуации, когда много компьютеров устанавливают удаленное подключение к одному компьютеру, на котором выполняется Windows PowerShell. В данном случае для повышения эффективности в службах IIS размещены веб-службы для управления (WS-Management).

Тип:	String
Position:	Named
Default value:	Wsman
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-Authentication

Задает способ проверки подлинности, используемый на сервере. Возможны следующие значения:

Basic — Базовая схема, в которой имя пользователя и пароль отправляются в виде четкого текста на сервер или прокси-сервер.
Default — используйте метод проверки подлинности, реализованный протоколом WS-Management. Это значение по умолчанию.
Digest — Дайджест — это схема ответа на вызов, которая использует строку данных, указанную сервером, для задачи.
Kerberos — клиентский компьютер и сервер взаимно проходят проверку подлинности с помощью сертификатов Kerberos.
Negotiate — Согласование — это схема ответа на вызовы, которая ведет переговоры с сервером или прокси-сервером, чтобы определить схему, используемую для проверки подлинности. Например, значение этого параметра позволяет согласованию определить, используется ли протокол Kerberos или NTLM.
CredSSP — Используйте проверку подлинности поставщика поддержки безопасности учетных данных (CredSSP), которая позволяет пользователю делегировать учетные данные. Этот параметр предназначен для команд, которые выполняются на одном удаленном компьютере, но собирают данные или выполняют дополнительные команды на других удаленных компьютерах.

Внимание

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

Тип:	AuthenticationMechanism
Aliases:	auth, am
Допустимые значения:	None, Default, Digest, Negotiate, Basic, Kerberos, ClientCertificate, Credssp
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-CertificateThumbprint

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

Сертификаты используются при проверке подлинности на основе сертификата клиента. Они могут сопоставляться только с учетными записями локальных пользователей и не работают с учетными записями доменов.

Чтобы получить отпечаток сертификата, используйте Get-Item команду Get-ChildItem или команду на диске Windows PowerShell Cert.

Тип:	String
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-ComputerName

Задает имя компьютера, для которого требуется выполнить операцию управления. Значение может быть полным доменным именем, NetBIOS-именем или IP-адресом. Используйте имя локального компьютера, используйте localhost или используйте точку (.), чтобы указать локальный компьютер. Локальный компьютер используется по умолчанию. Если удаленный компьютер находится в другом домене по отношению к пользователю, необходимо использовать полное имя домена. Можно передать значение этого параметра в командлет.

Тип:	String
Aliases:	cn
Position:	Named
Default value:	Localhost
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-ConnectionURI

Указывает конечную точку соединения. Строки имеют следующий формат:

<Transport>://<Server>:<Port>/<ApplicationName>

Следующая строка представляет собой правильно отформатированное значение для этого параметра:

http://Server01:8080/WSMAN

Значение URI должно быть указано полностью.

Тип:	Uri
Aliases:	CURI, CU
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-Credential

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

Тип:	PSCredential
Aliases:	cred, c
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	True
Принять подстановочные знаки:	False

-FilePath

Указывает путь к файлу, который используется для обновления ресурса управления. Для указания ресурса управления используется параметр ResourceURI и параметр SelectorSet. Например, следующая команда использует параметр FilePath:

Invoke-WSManAction -Action stopservice -ResourceUri wmicimv2/Win32_Service -SelectorSet @{Name="spooler"} -FilePath c:\input.xml -Authentication default

<p:StopService_INPUT xmlns:p="http://schemas.microsoft.com/wbem/wsman/1/wmi/root/cimv2/Win32_Service" />

Тип:	String
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-OptionSet

Передает набор параметров в службу, чтобы изменить или уточнить характер запроса. Это похоже на ключи, используемые в оболочках командной строки, поскольку они зависят от конкретной службы. Можно указать любое количество параметров.

В следующем примере демонстрируется синтаксис, который передает значения 1, 2 и 3 для параметров a, b и c:

-OptionSet @{a=1;b=2;c=3}

Тип:	Hashtable
Aliases:	os
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	True
Принять подстановочные знаки:	False

-Port

Указывает порт, используемый при подключении клиента к службе удаленного управления Windows. Если транспортом является HTTP, порт по умолчанию равен 80. Если транспортом является HTTPS, порт по умолчанию равен 443. При использовании HTTPS в качестве транспорта значение параметра ComputerName должно соответствовать общему имени (CN) сертификата сервера. Однако если параметр SkipCNCheck указан в составе параметра SessionOption, то общее имя сертификата сервера может отличаться от имени узла сервера. Параметр SkipCNCheck следует использовать только для доверенных компьютеров.

Тип:	Int32
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-ResourceURI

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

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

http://schemas.microsoft.com/wbem/wsman/1/wmi/root/cimv2/Win32_LogicalDisk

http://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/CIM_NumericSensor

Тип:	Uri
Aliases:	ruri
Position:	0
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	True
Принять подстановочные знаки:	False

-SelectorSet

Задает набор пар значений, используемых для выбора определенных экземпляров ресурсов управления. SelectorSet используется при наличии нескольких экземпляров ресурса. Значение SelectorSet должно быть хэш-таблицей.

В следующем примере показано, как ввести значение для этого параметра:

-SelectorSet @{Name="WinRM";ID="yyy"}

Тип:	Hashtable
Position:	2
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	True
Принять подстановочные знаки:	False

-SessionOption

Определяет набор расширенных параметров для сеанса WS-Management. Введите объект SessionOption, создаваемый с помощью командлета New-WSManSessionOption . Дополнительные сведения о доступных параметрах см. в разделе New-WSManSessionOption.

Тип:	SessionOption
Aliases:	so
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-UseSSL

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

WS-Management шифрует все содержимое PowerShell, передаваемое по сети. Параметр UseSSL позволяет задать дополнительную защиту HTTPS вместо HTTP. Если протокол SSL недоступен в порту, используемом для установки соединения, и вы указываете этот параметр, команда завершается с ошибкой.

Тип:	SwitchParameter
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-ValueSet

Указывает хэш-таблицу, помогающую изменить ресурс управления. Вы указываете ресурс управления с помощью параметров ResourceURI и SelectorSet . Значение параметра ValueSet должно быть хэш-таблицей.

Тип:	Hashtable
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

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

None

Невозможно передать объекты в этот командлет.

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

XmlElement

Этот командлет возвращает результат операции в виде объекта XmlElement .

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

Invoke-WSManAction

Синтаксис

Описание

Примеры

Пример 1. Вызов метода

Пример 2. Вызов метода

Пример 3. Вызов метода с указанными значениями параметров

Пример 4. Вызов метода на удаленном компьютере

Параметры

-Action

-ApplicationName

-Authentication

-CertificateThumbprint

-ComputerName

-ConnectionURI

-Credential

-FilePath

-OptionSet

-Port

-ResourceURI

-SelectorSet

-SessionOption

-UseSSL

-ValueSet

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

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

Дополнительные ресурсы

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

Invoke-WSManAction

Синтаксис

Описание

Примеры

Пример 1. Вызов метода

Пример 2. Вызов метода

Пример 3. Вызов метода с указанными значениями параметров

Пример 4. Вызов метода на удаленном компьютере

Параметры

-Action

-ApplicationName

-Authentication

-CertificateThumbprint

-ComputerName

-ConnectionURI

-Credential

-FilePath

-OptionSet

-Port

-ResourceURI

-SelectorSet

-SessionOption

-UseSSL

-ValueSet

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

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

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

Дополнительные ресурсы