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>]

Описание

Этот командлет доступен только на платформе Windows.

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

Этот командлет использует уровень подключения или транспорта WSMan для выполнения действия.

Примеры

Пример 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, соответствующего службе Spooler.

Возвращаемое значение указывает, выполнено ли действие успешно. В этом случае возвращаемое значение 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, соответствующего службе Spooler. Так как задан параметр 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:	None
Обязательно:	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:	None
Обязательно:	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
Aliases:	Path
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

Указывает порт, используемый при подключении клиента к службе WinRM. Если транспорт имеет значение 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

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

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

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

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