수신기에 대한 New-Item

아티클
11/16/2015

업데이트 날짜: 2013년 10월

적용 대상: Windows PowerShell 4.0

새 항목을 만듭니다.

구문

New-Item -Address <string> -Transport <string> [-Hostname <string>] [-Enabled] [-URLPrefix <string>] [-CertificateThumbprint <string>] [-Confirm] [-WhatIf] [<CommonParameters>]

설명

New-Item cmdlet은 새 항목을 만들고 해당 값을 설정합니다. 생성할 수 있는 항목 종류는 항목의 위치에 따라 다릅니다. 예를 들어 파일 시스템에서는 New-Item을 사용하여 파일과 폴더를 만들 수 있고 레지스트리에서는 New-Item을 사용하여 레지스트리 키와 항목을 만들 수 있습니다.

또한 New-Item은 생성되는 항목의 값을 설정할 수 있습니다. 예를 들어 새 파일을 만들 경우 New-Item을 사용하여 파일에 초기 내용을 추가할 수 있습니다.

매개 변수

-Address <string>

이 수신기가 만들어진 주소를 지정합니다. 값은 다음 중 하나일 수 있습니다.

--리터럴 문자열 "*". 와일드카드 문자(*)를 사용하면 명령이 모든 NIC(네트워크 인터페이스 카드)의 IP 주소를 모두 바인딩합니다.

--리터럴 문자열 "IP:". 뒤에는 점으로 구분된 IPv4 10진수 형식이나 콜론으로 구분된 IPv6 16진수 형식의 올바른 IP 주소가 옵니다.

--리터럴 문자열 "MAC:" 뒤에는 NIC의 MAC 주소가 옵니다. 예를 들면 다음과 같습니다. MAC:32-a3-58-90-be-cc.

필수 여부	true
위치	명명됨
기본값
파이프라인 입력 적용 여부	false
와일드카드 문자 허용 여부	false

-Transport <string>

WS-Management 프로토콜 요청 및 응답을 보내고 받는 데 사용할 전송을 지정합니다. 값은 HTTP 또는 HTTPS여야 합니다.

필수 여부	true
위치	명명됨
기본값
파이프라인 입력 적용 여부	false
와일드카드 문자 허용 여부	false

-Hostname <string>

WS-Management(WinRM) 서비스가 실행되는 컴퓨터의 호스트 이름을 지정합니다. 값은 정규화된 도메인 이름, IPv4 또는 IPv6 리터럴 문자열 또는 와일드카드 문자여야 합니다.

필수 여부	false
위치	명명됨
기본값
파이프라인 입력 적용 여부	false
와일드카드 문자 허용 여부	false

-Enabled

수신기를 사용하도록 설정할지 또는 사용하지 않도록 설정할지를 지정합니다. 기본값은 True입니다.

필수 여부	false
위치	명명됨
기본값
파이프라인 입력 적용 여부	false
와일드카드 문자 허용 여부	false

-URLPrefix <string>

HTTP 또는 HTTPS 요청을 수락할 URL 접두사입니다. 문자 a-z, A-Z, 9-0, 밑줄(_) 및 백슬래시(/)만 포함된 문자열입니다. 문자열은 백슬래시(/)로 시작하거나 끝나지 않아야 합니다. 예를 들어 컴퓨터 이름이 SampleMachine인 경우 WS-Management 클라이언트는 대상 주소에 http://SampleMachine/URLPrefix를 지정합니다.

필수 여부	false
위치	명명됨
기본값
파이프라인 입력 적용 여부	false
와일드카드 문자 허용 여부	false

-CertificateThumbprint <string>

서비스 인증서의 지문을 지정합니다.

이 값은 인증서의 Thumbprint 필드에 있는 2자리 16진수 값의 문자열을 나타냅니다. 이 작업을 수행할 권한이 있는 사용자 계정의 디지털 공개 키 인증서(X509)를 지정합니다. 인증서는 클라이언트 인증서 기반 인증에 사용됩니다. 인증서는 로컬 사용자 계정으로만 매핑될 수 있고 도메인 계정에는 사용할 수 없습니다. 인증서 지문을 가져오려면 Windows PowerShell Cert: 드라이브에서 Get-Item 또는 Get-ChildItem cmdlet을 사용합니다.

필수 여부	false
위치	명명됨
기본값
파이프라인 입력 적용 여부	false
와일드카드 문자 허용 여부	false

-Confirm

명령을 실행하기 전에 확인을 요청하는 메시지가 표시됩니다.

필수 여부	false
위치	명명됨
기본값
파이프라인 입력 적용 여부	false
와일드카드 문자 허용 여부	false

-WhatIf

명령을 실제로 실행하지 않으면서 명령을 실행할 경우 어떻게 되는지 설명해 보세요.

필수 여부	false
위치	명명됨
기본값
파이프라인 입력 적용 여부	false
와일드카드 문자 허용 여부	false

<CommonParameters>

이 cmdlet은 일반 매개 변수 -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer 및 -OutVariable을 지원합니다. 자세한 내용은 about_CommonParameters를 참조하세요.

입력 및 출력

입력 유형은 cmdlet에 파이프할 수 있는 개체의 유형입니다. 반환 유형은 cmdlet에서 반환되는 개체의 유형입니다.

입력

System.Object

새 항목의 값을 New-Item cmdlet으로 파이프할 수 있습니다.

출력

임의

참고

New-Item cmdlet은 모든 공급자가 공개하는 데이터에 사용할 수 있습니다. 세션에서 사용할 수 있는 공급자를 나열하려면 "Get-PsProvider"를 입력합니다. 자세한 내용은 About_Providers를 참조하세요.

예제 1

C:\PS>New-Item -Path WSMan:\localhost\Listener -Address * -Transport HTTP -force

This command creates an HTTP listener on any IP address on the computer.