netsh netsh

Применяется к: Windows Server (Semi-Annual Channel), Windows Server 2016 Applies to: Windows Server (Semi-Annual Channel), Windows Server 2016

Служебная программа для работы со сценариями командной строки сетевой оболочки, которая позволяет локально или удаленно отображать или изменять конфигурацию сети текущего компьютера. The Network Shell command-line scripting utility that allows you to, either locally or remotely, display or modify the network configuration of a currently running computer. Эту программу можно запустить в командной строке или в Windows PowerShell. You can start this utility at the command prompt or in Windows PowerShell.

Синтаксис Syntax

Параметры Parameters

Параметр Parameter	Описание Description
-a -a	Указывает, что вы вернетесь в командную строку Netsh после запуска Алиасфиле и имя текстового файла, содержащего одну или несколько команд Netsh. Specifies that you are returned to the netsh prompt after running Aliasfile and the name of the text file that contains one or more netsh commands.
-c -c	Указывает, что команда Netsh вводит указанный контекст netsh и контекст Netsh для ввода. Specifies that netsh enters the specified netsh context and the netsh context to enter.
-r -r	Указывает удаленный компьютер для настройки. Specifies the remote computer to configure.

Важно. При использовании этого параметра необходимо убедиться, что служба удаленного реестра запущена на удаленном компьютере. Important: If you use this parameter, you must make sure the Remote Registry service is running on the remote computer. Если он не работает, Windows выводит сообщение об ошибке «сетевой путь не найден». If it isn’t running, Windows displays a “Network Path Not Found” error message. -u \ -u \ Указывает домен и имя учетной записи пользователя для использования при выполнении команды Netsh в учетной записи пользователя. Specifies the domain and user account name to use while running the netsh command under a user account. Если опустить домен, по умолчанию будет использоваться локальный домен. If you omit the domain, the local domain is used by default. -p

Указывает пароль для учетной записи пользователя, указанной -u параметром. Specifies the password for the user account specified by the -u parameter. Задает выполняемую команду netsh. Specifies the netsh command to run. -f -f Выход из команды Netsh после запуска указанного файла скрипта. Exits the netsh command after running the specified script file. /? /? Отображение справки в командной строке. Displays help at the command prompt.

Комментарии Remarks

Если вы указали параметр -r , а затем еще одну команду, netsh выполняет команду на удаленном компьютере, а затем возвращается в Cmd.exe командной строке. If you specify -r followed by another command, netsh runs the command on the remote computer and then returns to the Cmd.exe command prompt. Если указать параметр -r без другой команды, команда Netsh откроется в удаленном режиме. If you specify -r without another command, netsh opens in remote mode. Процесс аналогичен использованию параметра set machine (задать компьютер) в командной строке Netsh. The process is similar to using set machine at the Netsh command prompt. При использовании параметра -r целевой компьютер задается только для текущего экземпляра Netsh. When you use -r, you set the target computer for the current instance of netsh only. После выхода и повторного ввода netsh целевой компьютер будет перенастроен в качестве локального компьютера. After you exit and reenter netsh, the target computer is reset as the local computer. Команды netsh можно выполнять на удаленном компьютере, указывая имя компьютера, хранящееся в WINS, имя UNC, имя в Интернете, которое должно быть разрешено сервером DNS, или IP-адрес. You can run netsh commands on a remote computer by specifying a computer name stored in WINS, a UNC name, an Internet name to be resolved by the DNS server, or an IP address.

Если строковое значение содержит пробелы между символами, необходимо заключить строковое значение в кавычки. If your string value contains spaces between characters, you must enclose the string value in quotation marks. Например -r «contoso remote device» . For example, -r «contoso remote device»

Синтаксис, контексты и форматирование команд Netsh Netsh Command Syntax, Contexts, and Formatting

Применяется к: Windows Server (Semi-Annual Channel), Windows Server 2016 Applies to: Windows Server (Semi-Annual Channel), Windows Server 2016

В этой статье описывается ввод контекстов и подконтекстов Netsh, синтаксис и форматирование команд Netsh, а также выполнение команд Netsh на локальных и удаленных компьютерах. You can use this topic to learn how to enter netsh contexts and subcontexts, understand netsh syntax and command formatting, and how to run netsh commands on local and remote computers.

Netsh — это служебная программа на базе командной строки, которая позволяет показывать или изменять конфигурацию сети активного компьютера. Netsh is a command-line scripting utility that allows you to display or modify the network configuration of a computer that is currently running. Команды Netsh можно выполнять путем ввода в командной строке Netsh, также их можно использовать в пакетных файлах или скриптах. Netsh commands can be run by typing commands at the netsh prompt and they can be used in batch files or scripts. Удаленные компьютеры и локальный компьютер можно настроить с помощью команд Netsh. Remote computers and the local computer can be configured by using netsh commands.

Netsh также обеспечивает возможность написания сценариев, которые позволяют выполнять группы команд в режиме партии на определенном компьютере. Netsh also provides a scripting feature that allows you to run a group of commands in batch mode against a specified computer. С помощью Netsh вы можете сохранить сценарий настройки в текстовом файле для архивирования или упрощения конфигурации других компьютеров. With netsh, you can save a configuration script in a text file for archival purposes or to help you configure other computers.

Контексты Netsh Netsh contexts

Netsh взаимодействует с другими компонентами операционной системы с помощью файлов -библиотеки динамической компоновки (DLL). Netsh interacts with other operating system components by using dynamic-link library (DLL) files.

Каждая вспомогательная библиотека DLL Netsh предоставляет широкий набор функций, называемых контекстом, который представляет собой группу команд для определенной серверной роли или возможности в сети. Each netsh helper DLL provides an extensive set of features called a context, which is a group of commands specific to a networking server role or feature. Эти контексты расширяют функциональные возможности Netsh, обеспечивая поддержку конфигурации и мониторинга для одной или нескольких служб, служебных программ или протоколов. These contexts extend the functionality of netsh by providing configuration and monitoring support for one or more services, utilities, or protocols. Например, Dhcpmon.dll предоставляет для Netsh контекст и набор команд для настройки DHCP-серверов и управления ими. For example, Dhcpmon.dll provides netsh with the context and set of commands necessary to configure and manage DHCP servers.

Получение списка контекстов Obtain a list of contexts

Список контекстов Netsh можно получить, открыв командную строку или Windows PowerShell на компьютере под управлением Windows Server 2016 или Windows 10. You can obtain a list of netsh contexts by opening either command prompt or Windows PowerShell on a computer running Windows Server 2016 or Windows 10. Введите команду netsh и нажмите клавишу ВВОД. Type the command netsh and press ENTER. Введите /? и нажмите клавишу ВВОД. Type /?, and then press ENTER.

Ниже приведен пример выходных данных для этих команд на компьютере под управлением Windows Server 2016 Datacenter. Following is example output for these commands on a computer running Windows Server 2016 Datacenter.

Подконтексты Subcontexts

Контексты Netsh могут содержать как команды, так и дополнительные контексты, называемые подконтекстами. Netsh contexts can contain both commands and additional contexts, called subcontexts. Например, в контексте маршрутизации можно перейти на подконтексты IP и IPv6. For example, within the Routing context, you can change to the IP and IPv6 subcontexts.

Чтобы просмотреть список команд и подконтекстов, которые можно использовать в контексте, введите имя контекста в командной строке Netsh и введите /? To display a list of commands and subcontexts that you can use within a context, at the netsh prompt, type the context name, and then type either /? или help. or help. Например, чтобы просмотреть список подконтекстов и команд, которые можно использовать в контексте маршрутизации, в командной строке Netsh (, т. е. netsh> ), введите один из следующих элементов: For example, to display a list of subcontexts and commands that you can use in the Routing context, at the netsh prompt (that is, netsh>), type one of the following:

routing /? routing /?

routing help routing help

Для выполнения задач в другом контексте без перехода из текущего контекста введите путь контекста команды, которую необходимо использовать в командной строке Netsh. To perform tasks in another context without changing from your current context, type the context path of the command you want to use at the netsh prompt. Например, чтобы добавить интерфейс с именем «Local Area Connection» («Подключение по локальной сети») в контексте IGMP без предварительного перехода на этот контекст, введите в командной строке Netsh следующую команду: For example, to add an interface named «Local Area Connection» in the IGMP context without first changing to the IGMP context, at the netsh prompt, type:

routing ip igmp add interface «Local Area Connection» startupqueryinterval=21 routing ip igmp add interface «Local Area Connection» startupqueryinterval=21

Выполнение команд Netsh Running netsh commands

Чтобы выполнить команду Netsh, необходимо запустить Netsh из командной строки, введя netsh и нажав клавишу ВВОД. To run a netsh command, you must start netsh from the command prompt by typing netsh and then pressing ENTER. Затем можно перейти к контексту, содержащему необходимую команду. Next, you can change to the context that contains the command you want to use. Доступные контексты зависят от установленных сетевых компонентов. The contexts that are available depend on the networking components that you have installed. Например, если ввести dhcp в командной строке Netsh и нажать клавишу ВВОД, Netsh перейдет на контекст DHCP-сервера. For example, if you type dhcp at the netsh prompt and press ENTER, netsh changes to the DHCP server context. Если служба DHCP не установлена, появится следующее сообщение: If you do not have DHCP installed, however, the following message appears:

The following command was not found: dhcp. (Следующая команда не найдена: dhcp.) The following command was not found: dhcp.

Условные обозначения форматирования Formatting Legend

Следующие условные обозначения форматирования можно использовать для интерпретации и соблюдения правильного синтаксиса команд Netsh при их выполнении в командной строке Netsh, в пакетном файле или скрипте. You can use the following formatting legend to interpret and use correct netsh command syntax when you run the command at the netsh prompt or in a batch file or script.

• Курсивом — указывается информация, которую необходимо задать при вводе команды. Text in Italic is information that you must supply while you type the command. Например, если у команды есть параметр с именем —UserName, необходимо ввести фактическое имя пользователя. For example, if a command has a parameter named —UserName, you must type the actual user name.
• Полужирным текстом указывается информация, которую необходимо ввести точно так же, как показано при вводе команды. Text in Bold is information that you must type exactly as shown while you type the command.
• Текст, за которым следует многоточие (. ) — это параметр, который может повторяться несколько раз в командной строке. Text followed by an ellipsis (. ) is a parameter that can be repeated several times in a command line.
• Текст в квадратных скобках [ ] — необязательный элемент. Text that is between brackets [ ] is an optional item.
• Текст в фигурных скобках < >с вариантами, разделенными вертикальной чертой, предоставляет набор вариантов, из которых необходимо выбрать только один, например . Text that is between braces < >with choices separated by a pipe provides a set of choices from which you must select only one, such as .
• Шрифтом Courier указывается код или выходные данные программы. Text that is formatted with the Courier font is code or program output.

Выполнение команд Netsh в командной строке или Windows PowerShell Running Netsh commands from the command prompt or Windows PowerShell

Чтобы запустить сетевую оболочку и ввести команду netsh в командной строке или в Windows PowerShell, можно использовать следующую команду: To start Network Shell and enter netsh at the command prompt or in Windows PowerShell, you can use the following command.

netsh netsh

Netsh — это служебная программа на базе командной строки, которая позволяет локально или удаленно просматривать или изменять конфигурацию сети активного компьютера. Netsh is a command-line scripting utility that allows you to, either locally or remotely, display or modify the network configuration of a currently running computer. При запуске без параметров Netsh открывает командную строку Netsh.exe (, т. е. netsh> ). Used without parameters, netsh opens the Netsh.exe command prompt (that is, netsh>).

Синтаксис Syntax

netsh[ -a ФайлПсевдонима] [ -c Контест ] [ -r УдаленныйКомпьютер] [ -u [ ИмяДомена\ ] ИмяПользователя ] [ -p Пароль | *] [<КомандаNetsh | -f ФайлСкрипта>] netsh[ -a AliasFile] [ -c Context ] [-r RemoteComputer] [ -u [ DomainName\ ] UserName ] [ -p Password | *] [<NetshCommand | -f ScriptFile>]

Параметры Parameters

-a

Необязательный параметр. Optional. Указывает, что вы вернетесь в командную строку Netsh после выполнения ФайлаПсевдонима. Specifies that you are returned to the netsh prompt after running AliasFile.

AliasFile

Необязательный параметр. Optional. Задает имя текстового файла, содержащего одну или несколько команд Netsh. Specifies the name of the text file that contains one or more netsh commands.

-c

Необязательный параметр. Optional. Указывает, что Netsh вводит заданный контекст Netsh. Specifies that netsh enters the specified netsh context.

Context

Необязательный параметр. Optional. Указывает контекст Netsh, который требуется ввести. Specifies the netsh context that you want to enter.

-r

Необязательный параметр. Optional. Указывает, что команда должна выполняться на удаленном компьютере. Specifies that you want the command to run on a remote computer.

При удаленном использовании некоторых команд Netsh на другом компьютере с параметром netsh –r на удаленном компьютере должна быть запущена служба удаленного реестра. When you use some netsh commands remotely on another computer with the netsh –r parameter, the Remote Registry service must be running on the remote computer. Если она не запущена, Windows выводит сообщение об ошибке Network Path Not Found (Сетевой путь не найден). If it is not running, Windows displays a “Network Path Not Found” error message.

RemoteComputer

Необязательный параметр. Optional. Указывает удаленный компьютер, который требуется настроить. Specifies the remote computer that you want to configure.

-u

Необязательный параметр. Optional. Указывает, что вы хотите выполнить команду Netsh в учетной записи пользователя. Specifies that you want to run the netsh command under a user account.

DomainName\\

Необязательный параметр. Optional. Указывает домен, в котором находится учетная запись пользователя. Specifies the domain where the user account is located. По умолчанию используется локальный домен, если не указан элемент ИмяДомена\ . The default is the local domain if DomainName\ is not specified.

UserName

Необязательный параметр. Optional. Указывает имя учетной записи пользователя. Specifies the user account name.

-p

Необязательный параметр. Optional. Указывает, что необходимо ввести пароль для учетной записи пользователя. Specifies that you want to provide a password for the user account.

Password

Необязательный параметр. Optional. Указывает пароль для учетной записи пользователя, заданный с помощью -u ИмяПользователя. Specifies the password for the user account that you specified with -u UserName.

NetshCommand

Необязательный параметр. Optional. Указывает команду Netsh, которую требуется выполнить. Specifies the netsh command that you want to run.

-f

Необязательный параметр. Optional. Завершает работу в Netsh после выполнения скрипта, назначенного с помощью параметра ФайлСкрипта. Exits netsh after running the script that you designate with ScriptFile.

ScriptFile

Необязательный параметр. Optional. Указывает скрипт, который требуется выполнить. Specifies the script that you want to run.

Необязательный параметр. Optional. Показывает справку в командной строке Netsh. Displays help at the netsh prompt.

Если вы указали -r , а затем еще одну команду, Netsh запускает команду на удаленном компьютере, а затем возвращает ответ в командной строке Cmd.exe. If you specify -r followed by another command, netsh runs the command on the remote computer and then returns to the Cmd.exe command prompt. Если указать -r без еще одной команды, Netsh открывается в удаленном режиме. If you specify -r without another command, netsh opens in remote mode. Процесс аналогичен использованию параметра set machine (задать компьютер) в командной строке Netsh. The process is similar to using set machine at the Netsh command prompt. При использовании -r необходимо задать целевой компьютер только для текущего экземпляра netsh. When you use -r , you set the target computer for the current instance of netsh only. После выхода и повторного ввода netsh целевой компьютер будет перенастроен в качестве локального компьютера. After you exit and reenter netsh, the target computer is reset as the local computer. Команды netsh можно выполнять на удаленном компьютере, указывая имя компьютера, хранящееся в WINS, имя UNC, имя в Интернете, которое должно быть разрешено сервером DNS, или IP-адрес. You can run netsh commands on a remote computer by specifying a computer name stored in WINS, a UNC name, an Internet name to be resolved by the DNS server, or an IP address.

Ввод строковых значений параметров для команд Netsh Typing parameter string values for netsh commands

В справочнике по командам Netsh есть команды с параметрами, для которых требуется строковое значение. Throughout the Netsh command reference there are commands that contain parameters for which a string value is required.

В случае когда строковое значение содержит пробелы между символами, например, если строковые значения состоят из нескольких слов, необходимо заключить строковое значение в кавычки. In the case where a string value contains spaces between characters, such as string values that consist of more than one word, it is required that you enclose the string value in quotation marks. Например, для параметра с именем interface со строковым значением Wireless Network Connection (Беспроводное сетевое подключение) заключите строковое значение в кавычки: For example, for a parameter named interface with a string value of Wireless Network Connection, use quotation marks around the string value:

interface=»Wireless Network Connection»