Set-WSManInstance

Синтаксис

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

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

URI

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

Описание

Примеры

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

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

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

Параметры

-ApplicationName

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

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

Рассмотрим пример.

http://server01:8080/WSMAN

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

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

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

-Authentication

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

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

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

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

-CertificateThumbprint

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

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

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

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

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

-ComputerName

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

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

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

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

-ConnectionURI

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

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

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

http://Server01:8080/WSMAN

Универсальный код ресурса (URI) должен быть полностью определённым.

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

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

-Credential

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

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

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

-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

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

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

-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" />

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

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

-Fragment

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

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

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

-OptionSet

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

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

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

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

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

-Port

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

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

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

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

-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

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

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

-SelectorSet

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

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

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

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

-SessionOption

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

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

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

-UseSSL

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

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

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

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

-ValueSet

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

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

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

CommonParameters

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

None

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

XmlElement

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

• Connect-WSMan
• Disable-WSManCredSSP
• Disconnect-WSMan
• Enable-WSManCredSSP
• Get-WSManCredSSP
• Get-WSManInstance
• Invoke-WSManAction
• New-WSManInstance
• New-WSManSessionOption (новая опция сеанса WSMan)
• Remove-WSManInstance
• Set-WSManQuickConfig
• Test-WSMan