Netsh 명령 구문, 컨텍스트 및 서식 지정Netsh Command Syntax, Contexts, and Formatting

적용 대상: Windows Server(반기 채널), Windows Server 2016Applies 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.

각 netsh 도우미 DLL은 네트워킹 서버 역할 또는 기능과 관련된 명령 그룹인 컨텍스트 라는 광범위한 기능 세트를 제공합니다.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은 DHCP 서버를 구성하고 관리하는 데 필요한 컨텍스트 및 명령 세트를 netsh에 제공합니다.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

Windows Server 2016 또는 Windows 10을 실행하는 컴퓨터에서 명령 프롬프트 또는 Windows PowerShell을 열어 netsh 컨텍스트 목록을 가져올 수 있습니다.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 명령을 입력하고 Enter 키를 누릅니다.Type the command netsh and press ENTER. /? 를 입력하고 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.

PS C:\Windows\system32> netsh
netsh>/?

The following commands are available:

Commands in this context:
..            - Goes up one context level.
?             - Displays a list of commands.
abort         - Discards changes made while in offline mode.
add           - Adds a configuration entry to a list of entries.
advfirewall   - Changes to the `netsh advfirewall' context.
alias         - Adds an alias.
branchcache   - Changes to the `netsh branchcache' context.
bridge        - Changes to the `netsh bridge' context.
bye           - Exits the program.
commit        - Commits changes made while in offline mode.
delete        - Deletes a configuration entry from a list of entries.
dhcpclient    - Changes to the `netsh dhcpclient' context.
dnsclient     - Changes to the `netsh dnsclient' context.
dump          - Displays a configuration script.
exec          - Runs a script file.
exit          - Exits the program.
firewall      - Changes to the `netsh firewall' context.
help          - Displays a list of commands.
http          - Changes to the `netsh http' context.
interface     - Changes to the `netsh interface' context.
ipsec         - Changes to the `netsh ipsec' context.
ipsecdosprotection - Changes to the `netsh ipsecdosprotection' context.
lan           - Changes to the `netsh lan' context.
namespace     - Changes to the `netsh namespace' context.
netio         - Changes to the `netsh netio' context.
offline       - Sets the current mode to offline.
online        - Sets the current mode to online.
popd          - Pops a context from the stack.
pushd         - Pushes current context on stack.
quit          - Exits the program.
ras           - Changes to the `netsh ras' context.
rpc           - Changes to the `netsh rpc' context.
set           - Updates configuration settings.
show          - Displays information.
trace         - Changes to the `netsh trace' context.
unalias       - Deletes an alias.
wfp           - Changes to the `netsh wfp' context.
winhttp       - Changes to the `netsh winhttp' context.
winsock       - Changes to the `netsh winsock' context.

The following sub-contexts are available:
 advfirewall branchcache bridge dhcpclient dnsclient firewall http interface ipsec ipsecdosprotection lan namespace netio ras rpc trace wfp winhttp winsock

To view help for a command, type the command, followed by a space, and then type ?.

하위 컨텍스트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 helprouting 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. 예를 들어 먼저 IGMP 컨텍스트를 변경하지 않고 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=21routing ip igmp add interface "Local Area Connection" startupqueryinterval=21

netsh 명령 실행Running netsh commands

netsh 명령을 실행하려면 netsh 를 입력하고 Enter 키를 눌러 명령 프롬프트에서 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. 예를 들어 netsh 프롬프트에 dhcp 를 입력하고 Enter 키를 누르면 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:

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.
  • 중괄호 { } 사이에 있고 파이프로 구분된 선택 항목을 포함하는 텍스트는 {enable|disable}처럼 하나만 선택해야 하는 선택 항목 세트를 제공합니다.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 {enable|disable}.
  • Courier 글꼴로 서식이 지정된 텍스트는 코드 또는 프로그램 출력입니다.Text that is formatted with the Courier font is code or program output.

명령 프롬프트 또는 Windows PowerShell에서 Netsh 명령 실행Running Netsh commands from the command prompt or Windows PowerShell

네트워크 셸을 시작하고 명령 프롬프트 또는 Windows PowerShell에서 netsh를 입력하려면 다음 명령을 사용하면 됩니다.To start Network Shell and enter netsh at the command prompt or in Windows PowerShell, you can use the following command.

netshnetsh

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 AliasFile] [ -c Context ] [ -r RemoteComputer] [ -u [ DomainName\ ] UserName ] [ -p Password | *] [{NetshCommand | -f ScriptFile}]netsh[ -a AliasFile] [ -c Context ] [-r RemoteComputer] [ -u [ DomainName\ ] UserName ] [ -p Password | *] [{NetshCommand | -f ScriptFile}]

매개 변수Parameters

-a

선택 사항입니다.Optional. AliasFile 을 실행한 후 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 –r 매개 변수를 사용하여 원격으로 일부 netsh 명령을 사용하는 경우 원격 컴퓨터에서 원격 레지스트리 서비스가 실행되고 있어야 합니다.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에서 "네트워크 경로를 찾을 수 없음" 오류 메시지를 표시합니다.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. DomainName\ 을 지정하지 않으면 기본값은 로컬 도메인입니다.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 UserName 을 사용하여 지정한 사용자 계정의 암호를 지정합니다.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. ScriptFile 을 사용하여 지정한 스크립트를 실행한 후 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. 이 프로세스는 Netsh 명령 프롬프트에서 set machine 을 사용하는 것과 비슷합니다.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. WINS에 저장된 컴퓨터 이름, UNC 이름, DNS 서버에서 확인할 인터넷 이름 또는 IP 주소를 지정하여 원격 컴퓨터에서 netsh 명령을 실행할 수 있습니다.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"