Set-WSManInstance

Ссылка

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

Изменяет данные управления, связанные с ресурсом.

Синтаксис

Set-WSManInstance
   [-ApplicationName <String>]
   [-ComputerName <String>]
   [-Dialect <Uri>]
   [-FilePath <String>]
   [-Fragment <String>]
   [-OptionSet <Hashtable>]
   [-Port <Int32>]
   [-ResourceURI] <Uri>
   [[-SelectorSet] <Hashtable>]
   [-SessionOption <SessionOption>]
   [-UseSSL]
   [-ValueSet <Hashtable>]
   [-Credential <PSCredential>]
   [-Authentication <AuthenticationMechanism>]
   [-CertificateThumbprint <String>]
   [<CommonParameters>]

Set-WSManInstance
   [-ConnectionURI <Uri>]
   [-Dialect <Uri>]
   [-FilePath <String>]
   [-Fragment <String>]
   [-OptionSet <Hashtable>]
   [-ResourceURI] <Uri>
   [[-SelectorSet] <Hashtable>]
   [-SessionOption <SessionOption>]
   [-ValueSet <Hashtable>]
   [-Credential <PSCredential>]
   [-Authentication <AuthenticationMechanism>]
   [-CertificateThumbprint <String>]
   [<CommonParameters>]

Описание

Командлет Set-WSManInstance изменяет сведения об управлении, связанные с ресурсом.

Для изменения информации он использует соединение/транспортный уровень службы удаленного управления Windows.

Примеры

Пример 1. Отключение прослушивателя на локальном компьютере

Set-WSManInstance -ResourceURI winrm/config/listener -SelectorSet @{address="*";transport="https"} -ValueSet @{Enabled="false"}

cfg                   : http://schemas.microsoft.com/wbem/wsman/1/config/listener
xsi                   : http://www.w3.org/2001/XMLSchema-instance
lang                  : en-US
Address               : *
Transport             : HTTPS
Port                  : 443
Hostname              :
Enabled               : false
URLPrefix             : wsman
CertificateThumbprint :
ListeningOn           : {127.0.0.1, 172.30.168.171, ::1, 2001:4898:0:fff:0:5efe:172.30.168.171...}

Эта команда отключает прослушиватель HTTPS на локальном компьютере.

Внимание

Параметр ValueSet учитывает регистр при сопоставлении указанных свойств.

Например, в этой команде

Это завершается ошибкой: -ValueSet @{enabled="False"}

Это успешно: -ValueSet @{Enabled="False"}

Пример 2. Установка максимального размера конверта на локальном компьютере

Set-WSManInstance -ResourceURI winrm/config -ValueSet @{MaxEnvelopeSizekb = "200"}

cfg                 : http://schemas.microsoft.com/wbem/wsman/1/config
lang                : en-US
MaxEnvelopeSizekb   : 200
MaxTimeoutms        : 60000
MaxBatchItems       : 32000
MaxProviderRequests : 4294967295
Client              : Client
Service             : Service
Winrs               : Winrs

Эта команда задает для параметра MaxEnvelopeSizekb значение 200 на локальном компьютере.

Внимание

Параметр ValueSet учитывает регистр при сопоставлении указанных свойств.

Например, воспользуемся указанной выше командой.

Это завершается ошибкой: -ValueSet @{MaxEnvelopeSizeKB ="200"}

Это успешно: -ValueSet @{MaxEnvelopeSizekb ="200"}

Пример 3. Отключение прослушивателя на удаленном компьютере

Set-WSManInstance -ResourceURI winrm/config/listener -ComputerName SERVER02 -SelectorSet @{address="*";transport="https"} -ValueSet @{Enabled="false"}

cfg                   : http://schemas.microsoft.com/wbem/wsman/1/config/listener
xsi                   : http://www.w3.org/2001/XMLSchema-instance
lang                  : en-US
Address               : *
Transport             : HTTPS
Port                  : 443
Hostname              :
Enabled               : false
URLPrefix             : wsman
CertificateThumbprint :
ListeningOn           : {127.0.0.1, 172.30.168.172, ::1, 2001:4898:0:fff:0:5efe:172.30.168.172...}

Эта команда отключает прослушиватель HTTPS на удаленном компьютере SERVER02.

Внимание

Параметр ValueSet учитывает регистр при сопоставлении указанных свойств.

Например, воспользуемся указанной выше командой.

Это завершается ошибкой: -ValueSet @{enabled="False"}

Это успешно: -ValueSet @{Enabled="False"}

Параметры

-ApplicationName

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

<transport>://<server>:<port>/<ApplicationName>

Например:

http://server01:8080/WSMAN

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

Type:	String
Position:	Named
Default value:	Wsman
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Authentication

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

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

Внимание

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

Type:	AuthenticationMechanism
Aliases:	auth, am
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-CertificateThumbprint

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

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

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ComputerName

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

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

Type:	String
Aliases:	cn
Position:	Named
Default value:	Localhost
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ConnectionURI

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

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

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

http://Server01:8080/WSMAN

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

Type:	Uri
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Credential

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

Type:	PSCredential
Aliases:	cred, c
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Dialect

Определяет диалект, используемый в предикате фильтра. Это может быть любой диалект, поддерживаемый удаленной службой. Для URI диалекта можно использовать следующие псевдонимы:

WQL: http://schemas.microsoft.com/wbem/wsman/1/WQL
Selector: http://schemas.microsoft.com/wbem/wsman/1/wsman/SelectorFilter
Association: http://schemas.dmtf.org/wbem/wsman/1/cimbinding/associationFilter

Type:	Uri
Position:	Named
Default value:	http://schemas.microsoft.com/wbem/wsman/1/WQL
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-FilePath

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

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

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

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

Type:	String
Aliases:	Path
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Fragment

Задает раздел внутри экземпляра, который должен быть обновлен или возвращен для указанной операции. Например, чтобы получить состояние службы spooler, укажите -Fragment Status.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-OptionSet

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

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

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

Type:	Hashtable
Aliases:	os
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Port

Указывает порт, используемый при подключении клиента к службе удаленного управления Windows. Если транспортом является HTTP, порт по умолчанию равен 80. Если транспортом является HTTPS, порт по умолчанию равен 443.

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

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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

Type:	Uri
Aliases:	ruri
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-SelectorSet

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

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

Type:	Hashtable
Position:	1
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-SessionOption

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

Type:	SessionOption
Aliases:	so
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-UseSSL

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

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

Type:	SwitchParameter
Aliases:	ssl
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ValueSet

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

Type:	Hashtable
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

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

None

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

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

XmlElement

Этот командлет возвращает обновленный экземпляр WSMan в виде объекта XmlElement .

Set-WSManInstance

Синтаксис

Описание

Примеры

Пример 1. Отключение прослушивателя на локальном компьютере

Пример 2. Установка максимального размера конверта на локальном компьютере

Пример 3. Отключение прослушивателя на удаленном компьютере

Параметры

-ApplicationName

-Authentication

-CertificateThumbprint

-ComputerName

-ConnectionURI

-Credential

-Dialect

-FilePath

-Fragment

-OptionSet

-Port

-ResourceURI

-SelectorSet

-SessionOption

-UseSSL

-ValueSet

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

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

Обратная связь

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

Set-WSManInstance

Синтаксис

Описание

Примеры

Пример 1. Отключение прослушивателя на локальном компьютере

Пример 2. Установка максимального размера конверта на локальном компьютере

Пример 3. Отключение прослушивателя на удаленном компьютере

Параметры

-ApplicationName

-Authentication

-CertificateThumbprint

-ComputerName

-ConnectionURI

-Credential

-Dialect

-FilePath

-Fragment

-OptionSet

-Port

-ResourceURI

-SelectorSet

-SessionOption

-UseSSL

-ValueSet

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

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

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

Обратная связь

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