Set-WSManQuickConfig (Microsoft.WSMan.Management)

Set-WSManQuickConfig

Модуль:

Microsoft.WSMan.Management

Настраивает локальный компьютер для удаленного управления.

Синтаксис

Set-WSManQuickConfig
   [-UseSSL]
   [-Force]
   [-SkipNetworkProfileCheck]
   [<CommonParameters>]

Описание

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

Командлет Set-WSManQuickConfig настраивает компьютер для получения удаленных команд PowerShell, отправляемых с помощью технологии веб-служб управления (WS-Management).

Set-WSManQuickConfig выполняет следующие действия:

• Проверяет, запущена ли служба WinRM. Если служба WinRM не запущена, она запускается.
• Устанавливает автоматический тип запуска службы WinRM.
• Создает прослушиватель для приема запросов на любой IP-адрес. Транспорт по умолчанию — HTTP.
• Включает исключение брандмауэра для трафика WinRM.

Чтобы запустить Set-WSManQuickConfig, запустите PowerShell с параметром Запуск от имени администратора.

Примеры

Пример 1. Включение удаленного управления локальным компьютером через HTTP.

В этом примере задается необходимая конфигурация для включения удаленного управления локальным компьютером. По умолчанию эта команда создает прослушиватель WS-Management на HTTP.

Set-WSManQuickConfig

Пример 2. Включение удаленного управления локальным компьютером через HTTPS.

В этом примере задается необходимая конфигурация для включения удаленного управления локальным компьютером. Параметр UseSSL указывает, что для связи с компьютером используется HTTPS.

Set-WSManQuickConfig -UseSSL

Параметры

-Force

Принудительно запускает команду без запроса подтверждения пользователя.

Тип :

SwitchParameter

Позиция:

Именованный

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

False

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

False

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

False

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

False

-SkipNetworkProfileCheck

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

Этот параметр не влияет на серверные версии Windows, которые по умолчанию имеют правило брандмауэра локальной подсети для общедоступных сетей. Если правило брандмауэра локальной подсети отключено в серверной версии Windows, Enable-PSRemoting повторно включает его, независимо от значения этого параметра.

Чтобы снять ограничение локальной подсети и включить удаленный доступ из всех мест в общедоступных сетях, используйте командлет Set-NetFirewallRule в модуле NetSecurity.

Этот параметр был введен в PowerShell 3.0.

Тип :

SwitchParameter

Позиция:

Именованный

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

False

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

False

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

False

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

False

-UseSSL

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

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

HTTPS требует ручной настройки правил WinRM и брандмауэра. Дополнительные сведения см. в разделе Как настроить WINRM для HTTPS.

Тип :

SwitchParameter

Позиция:

Именованный

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

False

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

False

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

False

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

False

Входы

Нет

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

Выходы

Строка

Этот командлет возвращает сообщение в виде объекта String, описывающего состояние конфигурации после операции.