Поиск по сайту:

Set-WSManInstance (Microsoft.WSMan.Management)

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 изменяет информацию управления, связанную с ресурсом.

Этот командлет использует уровень подключения/транспорта WinRM для изменения информации.

Примеры

Пример 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).

Тип :

String

Позиция:

Именованный

Значение по умолчанию:

Всман

Необходимый:

False

Примите ввод конвейера:

False

Принимайте подстановочные знаки:

False

-Authentication

Указывает механизм аутентификации, который будет использоваться на сервере. Возможные значения:

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

Осторожность

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

Тип :

AuthenticationMechanism

Псевдонимы:

auth, am

Позиция:

Именованный

Значение по умолчанию:

None

Необходимый:

False

Примите ввод конвейера:

False

Принимайте подстановочные знаки:

False

-CertificateThumbprint

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

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

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

Тип :

String

Позиция:

Именованный

Значение по умолчанию:

None

Необходимый:

False

Примите ввод конвейера:

False

Принимайте подстановочные знаки:

False

-ComputerName

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

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

Тип :

String

Псевдонимы:

cn

Позиция:

Именованный

Значение по умолчанию:

Локальныйхост

Необходимый:

False

Примите ввод конвейера:

False

Принимайте подстановочные знаки:

False

-ConnectionURI

Указывает конечную точку соединения. Формат этой строки:

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

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

http://Server01:8080/WSMAN

URI должен быть полностью квалифицированным.

Тип :

Ури

Позиция:

Именованный

Значение по умолчанию:

None

Необходимый:

False

Примите ввод конвейера:

False

Принимайте подстановочные знаки:

False

-Credential

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

Тип :

PSCredential

Псевдонимы:

cred, c

Позиция:

Именованный

Значение по умолчанию:

None

Необходимый:

False

Примите ввод конвейера:

True

Принимайте подстановочные знаки:

False

-Dialect

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

  • WQL: http://schemas.microsoft.com/wbem/wsman/1/WQL
  • Селектор: http://schemas.microsoft.com/wbem/wsman/1/wsman/SelectorFilter
  • Ассоциация: http://schemas.dmtf.org/wbem/wsman/1/cimbinding/associationFilter
Тип :

Ури

Позиция:

Именованный

Значение по умолчанию:

http://schemas.microsoft.com/wbem/wsman/1/WQL

Необходимый:

False

Примите ввод конвейера:

False

Принимайте подстановочные знаки:

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" />
Тип :

String

Псевдонимы:

Path

Позиция:

Именованный

Значение по умолчанию:

None

Необходимый:

False

Примите ввод конвейера:

True

Принимайте подстановочные знаки:

False

-Fragment

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

Тип :

String

Позиция:

Именованный

Значение по умолчанию:

None

Необходимый:

False

Примите ввод конвейера:

False

Принимайте подстановочные знаки:

False

-OptionSet

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

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

-OptionSet @{a=1;b=2;c=3}
Тип :

Хэш-таблица

Псевдонимы:

os

Позиция:

Именованный

Значение по умолчанию:

None

Необходимый:

False

Примите ввод конвейера:

False

Принимайте подстановочные знаки:

False

-Port

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

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

Тип :

Int32

Позиция:

Именованный

Значение по умолчанию:

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
Тип :

Ури

Псевдонимы:

ruri

Позиция:

0

Значение по умолчанию:

None

Необходимый:

True

Примите ввод конвейера:

False

Принимайте подстановочные знаки:

False

-SelectorSet

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

-SelectorSet @{Name="WinRM";ID="yyy"}
Тип :

Хэш-таблица

Позиция:

1

Значение по умолчанию:

None

Необходимый:

False

Примите ввод конвейера:

True

Принимайте подстановочные знаки:

False

-SessionOption

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

Тип :

SessionOption

Псевдонимы:

so

Позиция:

Именованный

Значение по умолчанию:

None

Необходимый:

False

Примите ввод конвейера:

False

Принимайте подстановочные знаки:

False

-UseSSL

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

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

Тип :

SwitchParameter

Псевдонимы:

ssl

Позиция:

Именованный

Значение по умолчанию:

None

Необходимый:

False

Примите ввод конвейера:

False

Принимайте подстановочные знаки:

False

-ValueSet

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

Тип :

Хэш-таблица

Позиция:

Именованный

Значение по умолчанию:

None

Необходимый:

False

Примите ввод конвейера:

True

Принимайте подстановочные знаки:

False

Входы

Нет

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

Выходы

XmlElement

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